[ANNOUNCEMENT] PhpDocumentor-1.4.0 (stable) Released.

The new PEAR package PhpDocumentor-1.4.0 (stable) has been released at http://pear.php.net/. Release notes ------------- Includes these PEAR items: Req #10670: Don&apos;t Die on Empty Tag Descriptions Bug #10864: PhpDocumentor dies when parsing illegal page-level docblock Bug #10870: Dead links generated with HTML:Smarty:PHP Bug #10871: Wrong rendering of inline {@internal}} Bug #10910: DOM templates create incorrect trees Bug #11409: PHP Notices accompany Global Never Found errors Doc #10675: Clear some errors.html items Doc #10730: Replace Sourceforge Trackers with PEAR Doc #10914: Can&apos;t use nested tags inside &lt;kbd&gt; or &lt;samp&gt; Doc #10972: @method does not work Doc #11032: param type1|type2 not documented Doc #11143: Provide a Minimal Tutorial File Setup Example Includes these Sourceforge items: - [1733938] regression: &quot;-&quot; not allowed anymore in converter (file)name - [1733936] &quot;phpdoc&quot; does not return with error code &quot;0&quot; on success - [1733345] inline @link tag renders wrong way - [1724990] @static tag example - [1724884] object return parameter value - [1722096] DocBlock template example does not work - [1720764] documentation update needed - [1672589] missing elements, bad links with HTML:Smarty:HandS - [1647423] memory_limit: bad if-clause - [1634153] require/include with concatenated file name - [1632496] {@internal}} becomes wrong on documentation - [1622538] List undocumented classes/functions - [1602988] Added --ignore-symlinks option - [1588942] Allow memory_limit setting in phpdoc.ini - [1588936] Show INI Path at Startup - [1585840] Refactored RETURNs #3 - [1574047] Refactored RETURNs #2 - [1574043] Refactored RETURNs #1 - [1543289] Apply ignore patterns to subdir of dir, instead of full path - [1543287] Use predefined PHP env var in phpdoc script - [1540666] patch for @property, @property-read and @property-write tags - [1124133] &lt;code&gt; and @include.... - [1044752] List undocumented classes/functions Package Info ------------ The phpDocumentor tool is a standalone auto-documentor similar to JavaDoc written in PHP. It differs from PHPDoc in that it is MUCH faster, parses a much wider range of php files, and comes with many customizations including 11 HTML templates, windows help file CHM output, PDF output, and XML DocBook peardoc2 output for use with documenting PEAR. In addition, it can do PHPXref source code highlighting and linking. Features (short list): -output in HTML, PDF (directly), CHM (with windows help compiler), XML DocBook -very fast -web and command-line interface -fully customizable output with Smarty-based templates -recognizes JavaDoc-style documentation with special tags customized for PHP 4 -automatic linking, class inheritance diagrams and intelligent override -customizable source code highlighting, with phpxref-style cross-referencing -parses standard README/CHANGELOG/INSTALL/FAQ files and includes them directly in documentation -generates a todo list from @todo tags in source -generates multiple documentation sets based on @access private, @internal and {@internal} tags -example php files can be placed directly in documentation with highlighting and phpxref linking using the @example tag -linking between external manual and API documentation is possible at the sub-section level in all output formats -easily extended for specific documentation needs with Converter -full documentation of every feature, manual can be generated directly from the source code with "phpdoc -c makedocs" in any format desired. -current manual always available at http://www.phpdoc.org/manual.php -user .ini files can be used to control output, multiple outputs can be generated at once **WARNING**: To use the web interface, you must set PEAR's data_dir to a subdirectory of document root. If browsing to http://localhost/index.php displays /path/to/htdocs/index.php, set data_dir to a subdirectory of /path/to/htdocs: $ pear config-set data_dir /path/to/htdocs/pear $ pear install PhpDocumentor http://localhost/pear/PhpDocumentor is the web interface Related Links ------------- Package home: http://pear.php.net/package/PhpDocumentor Changelog: http://pear.php.net/package/PhpDocumentor/download/1.4.0 Download: http://download.pear.php.net/package/PhpDocumentor-1.4.0.tgz Authors ------- Joshua Eichorn <jeichorn@JoshuaEichorn.com> (lead) Greg Beaver (lead) Chuck Burgess (developer) Andrew Morton (developer)