Re: Publishing API documentation for each release

Hi: On Tue, Mar 09, 2004 at 12:13:32AM +0100, Stefan Neufeind wrote: > But using HTML directly is imho not a good solution, since HTML is > not well structured at all. I'm against using plain HTML for the > whole doc (at the moment) ... For the main documentation, I agree. For the docs generated directly from package source code using phpDocumentor, I agree with Martin, HTML only output is just fine. I don't see these docs being very important and spending a lot of effort converting them to other formats doesn't seem worth it. If users want other formats for the API docs, they're free to run phpDocumentor on the source files whenever they want. Similarly, if the PEAR team wants to produce other formats, we should use phpDocumentor to do that direclty rather than trying to massage phpDocumentor's docbook output. --Dan -- T H E A N A L Y S I S A N D S O L U T I O N S C O M P A N Y data intensive web and database programming http://www.AnalysisAndSolutions.com/ 4015 7th Ave #4, Brooklyn NY 11232 v: 718-854-0335 f: 718-854-0409