Description: ------------ I just installed PHPDocumentor 1.3.0RC6 by following the INSTALL instructions. Everything seems to function properly, except when I try to view documentation on individual files. I believe the problem is because the pages being generated are xhtml pages and have the <?xml version="1.0" encoding="iso-8859-1"?> at the beginning of the document. I know this is causing the problem because removing that first line makes the page come up just fine. Even though the page is just html, apache is interpreting it as php because it is called something like _filename.php.html. I think a possible solution would be to rename the file to something like _filename_php.html so that the web server doesn't get confused what file type it is. I tried renaming the files and they load properly, but of course they aren't linked anymore. Turning off short_open_tags in php.ini would also fix this problem, but most of my code uses short_open_tags, so it would break more than it would fix if I changed it. Expected result: ---------------- Pages that don't contain a parse error. Actual result: -------------- Documentation for individual pages produce a parse error. These pages have a filename of the following format: _filename.php.html

Description: ------------ I just installed PHPDocumentor 1.3.0RC6 by following the INSTALL instructions. Everything seems to function properly, except when I try to view documentation on individual files. I believe the problem is because the pages being generated are xhtml pages and have the <?xml version="1.0" encoding="iso-8859-1"?> at the beginning of the document. I know this is causing the problem because removing that first line makes the page come up just fine. Even though the page is just html, apache is interpreting it as php because it is called something like _filename.php.html. I think a possible solution would be to rename the file to something like _filename_php.html so that the web server doesn't get confused what file type it is. I tried renaming the files and they load properly, but of course they aren't linked anymore. Turning off short_open_tags in php.ini would also fix this problem, but most of my code uses short_open_tags, so it would break more than it would fix if I changed it. Expected result: ---------------- Pages that don't contain a parse error. Actual result: -------------- Documentation for individual pages produce a parse error. These pages have a filename of the following format: _filename.php.html

your server is set to parse <? as PHP tags, and also to parse html files as PHP format. Please turn off short_open_tags, or set the serevr to parse only .php as php files and the problem with go away. This is not a phpDocumentor problem

If anyone runs into this problem, you can just add a .htaccess file with the following directive to fix it. The file belongs in the same folder where the documentation is being generated. php_flag short_open_tag Off This file will then allow you to keep the rest of your code using the short_open_tag but selectively change it for just the documentation.

That is a workaround, not a fix. The file is still run through the PHP interpreter, while it shouldn't. Apache will interpret files with .php. anywhere in their name. See also http://httpd.apache.org/docs/2.2/mod/mod_mime.html#multipleext Since Apache is the most common environment for PHP, this is a bug in PHP Documentor.

Perhaps this is something that PhpDocumentor could understand is an external constraint and plan around. I'll look at whether or not I can rename the generated files to use the text "-dot-" in place of "." in documentation filenames, since it seems that trying to preserve the parsed file's filename inside the generated doc's filename is the culprit here.

Common subdirectories: phpdoc_original/phpDocumentor/Converters and phpdoc_new/phpDocumentor/Converters diff -ud phpdoc_original/phpDocumentor/Parser.inc phpdoc_new/phpDocumentor/Parser.inc --- phpdoc_original/phpDocumentor/Parser.inc 2008-03-01 14:45:21.000000000 -0500 +++ phpdoc_new/phpDocumentor/Parser.inc 2008-03-01 14:38:42.000000000 -0500 @@ -556,6 +556,7 @@ $name = str_replace( ':', '', dirname($path) . PATH_DELIMITER . $page->getFile() ); $tmp = explode( PATH_DELIMITER, $name ); $name = implode( "---", array_slice( $tmp, $base ) ); + $name = str_replace('.php','-dot-php',$name); // if base is '', drive letter is present in windows $page->setName($name); diff -ud phpdoc_original/phpDocumentor/phpDocumentorTParser.inc phpdoc_new/phpDocumentor/phpDocumentorTParser.inc --- phpdoc_original/phpDocumentor/phpDocumentorTParser.inc 2008-03-01 14:45:15.000000000 -0500 +++ phpdoc_new/phpDocumentor/phpDocumentorTParser.inc 2008-03-01 14:41:42.000000000 -0500 @@ -251,6 +251,7 @@ . PATH_DELIMITER . $page->getFile()); $tmp = explode(PATH_DELIMITER, $name); $name = implode("---", array_slice($tmp, $base)); + $name = str_replace('.php','-dot-php',$name); // if base is '', drive letter is present in windows $page->setName($name); Common subdirectories: phpdoc_original/phpDocumentor/Smarty-2.6.0 and phpdoc_new/phpDocumentor/Smarty-2.6.0

No more feature work on phpDocumentor 1.x. Check out the new phpDocumentor 2.x (http://www.phpdoc.org/).