Re: RFC: Self-Hosted PHP Documentation

From: Date: Sun, 11 May 2003 15:00:52 +0000
Subject: Re: RFC: Self-Hosted PHP Documentation
References: 1 2  Groups: php.doc php.gtk.doc php.mirrors php.pear.doc 
Request: Send a blank email to phpdoc+get-969353349@lists.php.net to get a copy of this message
In general: a good draft! :-)
Thanks.
Thats the point! IMO instead of writing tons of code and wasting time with project specific solutions for the "rendering docbook?"-problem, it is time to start writing a native Docbook-Writer/Reader.
Well, as I said, I thought about using some XML format. I am not yet convinced that DocBook XML is the real good choice for this. I thought about some preparsed XML structure with much less tags to deal with. DocBook is so huge that coding a generic viewer would take much more time then I am willing to invest in this. It would be interesting indeed ;) What I thought about is to have a subset of DocBook or a simpler XML format to use for this task and implement a viewer for that.
For PHP-Manual specific stuff like showing functions only if there are in the installed PHP-build or highlighted sources such an application could have book-specific Filters or Hooks.
What you propose does not seem to be impossible, and it's quite impressive. But are there any guys here who are willing to join in such a development? Goba

« previous php.doc (#969353349) next »