Read more ..
$ pear channel-discover pear.phpdoc.org $ pear install phpdoc/phpDocumentor
Read more ..
$ phpdoc -d . -t docs
phpDocumentor 2 is a tool with which it is possible to generate documentation from your PHP source code. With this documentation you can provide your consumers with more information regarding the functionality embedded within your source and not only what is usable to them from your user interface.
Documentation generated by phpDocumentor 2 does not aim to be a replacement for conventional documentation but is rather supplemental, or reference, documentation.
This documention can prove to be very useful in the following, example, situations:
phpDocumentor 2 contains an incredibly flexible template system which enabled you to alter your output in any way imaginable. This can range from simply applying your own branding for the HTML output by merely altering a couple of CSS files to determining which types of output are generated and where they are made available.
phpDocumentor 2 is capable of extracting interesting information and present those in the form of graphs and reports. The following are currently supported:
This list will only grow in the future to help you determine where to invest your resources in order to make your code more stable and maintainable.
phpDocumentor 2 is build with extendability in mind. Using ideas from Aspect Oriented Development (AoP) that are powered by the Event Dispatcher by symfony are phpDocumentor 2 Plugins one of the more powerful tools in the toolset.