PEAR::PHPDoc --> DocBook (was Re: [PHP-DOC] developers manual and users manual)

(CC'ing to the pear-dev list so the phpdoc developers can comment too) Hi Gabor --- Gabor Hojtsy <gabor@hojtsy.hu> wrote: > > Indeed, in particular in PEAR we are working > towards > > allowing simpler generation of class > documentations. > > As we are already using javadoc-style comments in > the > > code, we could generate the DocBook prototypes > > programatically, the PEAR::PHPDoc tool is being > > modified for that purpose. > > In what stage is this project? I will hold a session > about > documenting PHP code with PHPdoc and DocBook XML and > > planned to develop a tool (probably based on > phpdoc.org's > phpdoc implementation) to convert phpdoc comments to > DocBook > XML. AFAICT there are 2 tools being developed one is to update de PEAR::PHPDoc to generate DocBook, and as such I am not sure on the status, but there has been lately a long discussion on the topic, one of the latest msgs in the thread was: http://marc.theaimsgroup.com/?l=pear-dev&m=102902769904693&w=2 (more on that thread at: http://marc.theaimsgroup.com/?t=102901271000002&r=1&w=2 ) The other is aimed at making tools for converting from OpenOffice XML format to DocBook: http://marc.theaimsgroup.com/?l=pear-dev&m=102910323408027&w=2 The script seems to work, although I had not tested it because I do not have libdom installed on Solaris. > If this is an already ongoing project in PEAR, > I should > not work on a separate one :) BTW I have seen some > steps in > integrating the PEAR::PHPDoc implementation with > phpdoc.org's > (which is superior in many aspects). Is there any > progress > in this field? > > Goba I think that Alexander is talking to the guys who are updating PEAR::phpdoc, hopefully they will chip in w/ some more info in this thread. I am sure they will welcome ideas/help/code ;-) ===== --- Jesus M. Castagnetto <jmcastagnetto@php.net> __________________________________________________ Do You Yahoo!? HotJobs - Search Thousands of New Jobs http://www.hotjobs.com