[LOG4PHP-135] Migrate API documentation generation to Doxygen

• Type: Improvement
• Status: Closed
• Priority: Minor
• Resolution: Not A Problem
• Component/s: Documentation
• Assignee: Unassigned
• Reporter: Ivan Habunek
• Created: 23/Jan/11 09:38
• Updated: 08/Oct/12 08:29
• Resolved: 08/Oct/12 08:29

Description

The last version of PHPdocumentor was released on 2008-03-31 and there seems to be no indication that development will resume. This will in time start to present a problem.

Doxygen (http://www.stack.nl/~dimitri/doxygen/) has become somewhat of an industry standard, generating API docs for many programming languages. The development is ongoing. Support for PHP has been added relatively recently, but most tags used by PHPdocumentor are either supported or other tags with similar functionality exist. It already has great support for PHP 5.3 namespaces which PHPdocumentor lacks, and which we will want to use at some point in the future.

I have done some experimentation and believe this is doable, although it will require some work. It is not currently a priority, but let this issue be a reminder.