[ANNOUNCEMENT] PhpDocumentor-1.4.4 (stable) Released.
| From: | PEAR Announce | Date: | Sat, 03 Dec 2011 22:45:16 +0000 |
| Subject: | [ANNOUNCEMENT] PhpDocumentor-1.4.4 (stable) Released. | ||
| Groups: | php.pear.general | ||
| Request: | Send a blank email to pear-general+get-31318@lists.php.net to get a copy of this message | ||
The new PEAR package PhpDocumentor-1.4.4 (stable) has been released at http://pear.php.net/.
Release notes
-------------
Includes these PEAR items:
* Fix Bug #11543: empty @todo tags/comments shouldn't be included in TODO list [ashnazg]
* Fix Bug #12704: XML/Beautifier removed comment in XML Docbook peardoc2 converter
template [ashnazg]
* Fix Bug #13606: parameter name and description do not line up in generated docs [ashnazg]
* Fix Bug #13653: Media file copy - copies incorrect file [ashnazg]
* Fix Bug #14201: templatebase not working as intended [ashnazg]
* Fix Bug #14640: class witch extending DOMDocument [ashnazg]
* Fix Bug #16279: Type Hints in Function Signature Cause Loss of @param type [ashnazg]
* Fix Bug #16546: Default parser uses php 4.0 standards [ashnazg]
* Fix Bug #16825: Templates Point to Nonexistent Image Files [ashnazg]
* Fix Bug #16826: Unused media folder and files exist [ashnazg]
* Fix Bug #17395: Fatal Error when trying to run document [ashnazg]
* Fix Bug #18058: Patch: fix some notices (which may cause a crash of other tools) [ashnazg]
* Fix Bug #18100: phpdocu-general@sourceforge.net bounces [ashnazg]
* Fix Bug #18220: Truncated filenames in Converter files [ashnazg]
* Fix Bug #18782: class tree generation mistake [ashnazg]
* Fix Bug #18870: Class tree wont shows implemented interfaces if class has no childs [ashnazg]
* Fix Bug #18871: Class tree wont shows internal PHP interfaces [ashnazg]
* Fix Bug #18872: Class tree puts comma uncorrectly in interfaces list [ashnazg]
* Fix Bug #19017: remove error_reporting (for PEAR QA team) [ashnazg]
* Implement Feature #12211: @inheritdoc not working for child methods & variables [ashnazg]
* Implement Feature #15580: Add link back from api document to pear website or package website
[ashnazg]
* Implement Feature #17906: Please, consider realising 'Plain.php' file under PHP 3.01
license [ashnazg]
Includes these Sourceforge items:
* [2155014] fatal error when parsing 'myclass extends DOMDocument'
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.4
Download: http://download.pear.php.net/package/PhpDocumentor-1.4.4.tgz
Authors
-------
Chuck Burgess (lead)