Re: Machine-readable PHP documentation?
| From: | Hannes Magnusson | Date: | Wed, 04 Jun 2008 16:53:26 +0000 |
| Subject: | Re: Machine-readable PHP documentation? | ||
| References: | 1 2 3 4 5 6 7 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969378999@lists.php.net to get a copy of this message | ||
On Wed, Jun 4, 2008 at 9:44 AM, pedram salehpoor
<pedram.salehpoor@gmail.com> wrote:
>
>
> On Tue, Jun 3, 2008 at 4:23 PM, Edward Z. Yang
> <edwardzyang@thewritingpot.com> wrote:
>> Use configure.php. An outstanding project is to make all of PHP's
>> documentation sources standalone valid XML files, but for now, you'll
>> need to glom them all together.
>>
> It seems really an interesting project for making all of them standalone
> valid XML files.Where should we start it and what benefits It will have for
> phpdoc?
We would need our own DTD (based on the DocBook5 DTD obviously) which
would do some magic including various entities we use.
The benefits include being able to parse each file standalone, meaning
it would truly be possible to update single files.
Along those lines we would be able to distribute separate downloads
for each extension for instance and lots of nifty features along those
lines.
It would be great if we could switch over to XInclude in the way...
-Hannes