Re: Publishing API documentation for each release
| From: | David Costa | Date: | Mon, 08 Mar 2004 21:18:10 +0000 |
| Subject: | Re: Publishing API documentation for each release | ||
| References: | 1 2 3 | Groups: | php.pear.doc |
| Request: | Send a blank email to pear-doc+get-2923@lists.php.net to get a copy of this message | ||
On Mar 8, 2004, at 8:30 PM, Martin Jansen wrote:
That would be great. +1 for me. It would be much better to use PhpDocumentor's HTML render then converting to Docbook and back to HTML. IMHO Thanks, Regards David CostaI have been playing around with this idea a bit more in the past days and ran into a problem: Converting the inline documentation into Docbook, and transforming it into HTML later on, does not work out very well: The intermediate step between inline documentation and HTML is cumbersome, because one has to ensure that the generated XML files are valid, and it takes a lot more time to convert from Docbook to HTML than it takes to convert to HTML directly within phpDocumentor. Because of that I'd like to suggest to drop exporting to Docbook and use one of phpDocumentor's HTML renderers instead. Comments? Objections?