$Id: Release-1.4.0 248248 2007-12-14 11:51:59Z ashnazg $ PhpDocumentor Version 1.4.0 ################################################################################ http://www.phpdoc.org Gregory Beaver cellog@php.net Joshua Eichorn jeichorn@phpdoc.org ################################################################################ ################################################################################ The phpDocumentor team would like to announce the release of phpDocumentor 1.4.0. This feature release adds initial support for documenting "magic" properties, a couple of new runtime options, plus a few minor internal enhancements. ------ IMPORTANT: phpDocumentor 1.4.0 requires PHP version 4.2.0 or greater. phpDocumentor will function best with PHP version 4.3.0 or greater, as it will use of the tokenizer extension if php 4.3.0 is installed for a tremendous increase in parsing speed. PHP version 5.1.0 or newer is recommended to take advantage of PHP5-only features. WARNING: A bug in PHP v5.2.1 can cause PhpDocumentor v1.3.1 and older to spiral into an infinite loop when parsing tutorial documents. PhpDocumentor v1.3.2 and newer will crash itself at the beginning of the tutorial parsing stage if it detects PHP v5.2.1 being used to parse tutorials. ------ Speaking of speed, do NOT run the PDF Converter with --sourcecode = on for any medium to large sized projects. I had to kill a PDF generation after 36 hours on a Pentium IV 2.66GHz computer - 36 hours! The design of the PDF generation library is tremendously inefficient, probably on the order of O(n^2). I'd fix this if I knew anything about PDF. If there are any users out there with the time and expertise to look into the algorithms used by CPdf, we would all appreciate it. A full listing of all closed bugs and feature requests can be found in the next section of the notes. phpDocumentor 1.4.0 is ready for production use documenting any PHP project, download it and try the most advanced solution for PHP documentation today. ################################################################################ The following PEAR items are included in version 1.4.0: Bug #11409: PHP Notices accompany Global Never Found errors Req #10670: Don\'t Die on Empty Tag Descriptions Doc #10675: Clear some errors.html items Doc #10730: Replace Sourceforge Trackers with PEAR 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 Doc #10914: Can't use nested tags inside <kbd> or <samp> Doc #10972: @method does not work Doc #11032: param type1|type2 not documented Doc #11143: Provide a Minimal Tutorial File Setup Example The following Sourceforge items are included in version 1.4.0: - [1733938] regression: "-" not allowed anymore in converter (file)name - [1733936] "phpdoc" does not return with error code "0" 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 (thanks Sebastian Marconi) - [1602988] Added --ignore-symlinks option (thanks Daniel Hahler) - [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 (thanks Daniel Hahler) - [1543287] Use predefined PHP env var in phpdoc script (thanks Daniel Hahler) - [1540666] patch for @property, @property-read and @property-write tags (thanks Derick Rethans) - [1124133] and @include.... - [1044752] List undocumented classes/functions You can view the bug details or reopen one if you think it's not totally fixed at: http://pear.php.net/bugs/search.php?cmd=display&package_name%5B%5D=PhpDocumentor http://sourceforge.net/tracker/?group_id=11194&atid=111194 ################################################################################ The documentation has been updated for this release you can view it at http://www.phpdoc.org/docs or in the distribution in the spec directory The changelog is available in the tarball, or online at http://pear.php.net/package/PhpDocumentor/download/ You can download the newest version from http://pear.php.net/package/PhpDocumentor/download/ and http://phpdocu.sourceforge.net/downloads.php And of course you can reach the webpage at http://pear.php.net/package/PhpDocumentor/ or http://phpdocu.sourceforge.net/ or http://phpdoc.org/ enjoy -gregory beaver -joshua eichorn vim: set expandtab :