Detailed Documentation of the tag specification are available with this distribution in the specs/ directory, and online at http://phpdocu.sourceforge.net/spec/
A brief howto tutorial is available in specs/howto.html and online at http://phpdocu.sourceforge.net/spec/howto.html
If you think you've found a bug in phpDocumentor, please check our bug tracker online at http://sourceforge.net/tracker/?func=browse&group_id=11194&atid=111194, the bug may have already been fixed (we develop at a rapid rate). If you don't find it, please submit a bug, and we will attempt to fix it as quickly as possible.
If there is a feature you're dying to have, check our feature tracker at http://sourceforge.net/tracker/?func=browse&group_id=11194&atid=361194. Please don't hesitate to look right at the source code and help apply your feature. We love that, and can easily give you access to the cvs.
If you would like to help out with phpDocumentor, don't be shy. Email Joshua Eichorn right away and say you'd like to be added to the developer team. We need people who are willing to develop Converters, translate documentation, and handle various bugs and feature requests as they come up. phpDocumentor is fast becoming the de facto standard of automatic documentors in PHP, so it is in your best interest to make sure it works the way you need it to work.
the {@link Converter} base class pass elements to the {@link Converter::Convert()} method (which must be overridden in child classes) and splits the elements up by their type. There are 3 types of elements, Package-level docs, Procedural elements and Object-oriented elements. Package-level docs are {@link phpDocumentor#parserPackagePage} elements.Procedural elements are {@link phpDocumentor#parserFunction}s, {@link phpDocumentor#parserDefine}s, {@link phpDocumentor#parserInclude}s, and {@link phpDocumentor#parserGlobal}s, and Object-oriented elements are {@link phpDocumentor#parserClass}es, {@link phpDocumentor#parserMethod}s, and {@link phpDocumentor#parserVar}s.
The {@link Converter::walk()} method does the primary work of converting abstract parsed data into Template-enabled data, or directly into output. phpDocumentor 1.1 ships with the abstract Converter and a standard {@link HTMLdefaultConverter} for output to HTML formats. The converter is described in detail in the Converter howto.
After conversion, Converter calls the {@link Converter::Output()} method for each converter, and voila, the data is written out!