phpDocumentor

phpDocumentor is sometimes referred to as phpdoc or phpdocu.

Similar to Javadoc and RDoc, it is written in PHP and can be used from the command line or a web interface to create professional documentation from PHP source code.

Features:

• 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
• 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.
• User .ini files can be used to control output, multiple outputs can be generated at once.

What is new in this release:

• ADDED:
• Information how to donate to phpDocumentor using gittip
• Profiling information and process
• CHANGED:
• Moved the external class documentation code to their own router
• Replaced MarkDownExtra dependency with Parsedown
• Rewrote a lot of the documentation; still a work in progress
• FIXED:
• External class documentation had ../files prepended
• Todo tags did not show up in Twig templates
• Arguments passed by reference did not show up as being by reference
• Prevent output from wrapping in Windows console
• Cleaned up code based on Continuous Integration messages
• Timezone issues on some machines
• Various issues in several templates

What is new in version 2.0.1:

• FIXED:
• Generated phar files could not be set to executable and ran.
• Missing File-level DocBlocks were not detected.
• Classes and namespace were not generated in Windows.
• Notices were thrown with the Clean template.
• In windows were paths calculated incorrectly.