You are viewing a plain text version of this content. The canonical link for it is here.
Posted to log4php-dev@logging.apache.org by "Ivan Habunek (JIRA)" <ji...@apache.org> on 2012/10/08 10:30:02 UTC

[jira] [Closed] (LOG4PHP-135) Migrate API documentation generation to Doxygen

     [ https://issues.apache.org/jira/browse/LOG4PHP-135?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Ivan Habunek closed LOG4PHP-135.
--------------------------------

    Resolution: Not A Problem

Several things happened since this issue was created.
* phpdoc is being updated
* discovered apigen which is even better

Moved to apigen. Maybe reconsider phpdoc once v2 is stable.
                
> Migrate API documentation generation to Doxygen
> -----------------------------------------------
>
>                 Key: LOG4PHP-135
>                 URL: https://issues.apache.org/jira/browse/LOG4PHP-135
>             Project: Log4php
>          Issue Type: Improvement
>          Components: Documentation
>            Reporter: Ivan Habunek
>            Priority: Minor
>
> 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.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira