On May 23, 2:17 pm, [EMAIL PROTECTED] wrote:
> or tell me how to fix the docs and I'll do it.

Fixing the docs is a bit of a pig because it is a Linux-based XML-
based (DocBook) compile-style activity. I'll fix this one right now.
Sometime, if you fancy a go, here are some notes on the process:

PHP uses DocBook for extension documentation. Documentation is written
in XML and then 'make' is used to generate various document formats
(e.g. html, pdf, Windows Help, etc.).

Documentation is held in the php cvs repository. Check out the phpdoc
folder from the PHP CVS repository.

Note, this includes the howto and scripts mentioned in Dan's
presentation...

Advice from Dan Scott: The core information you need to know to get
started is here: http://doc.php.net/php/dochowto/index.php. The
overall PHP documentation project is described in this presentation:
http://coffeecode.net/uploads/talks/phptropics-docs.pdf

The following is the page in the howto doc that describes the
conventions to follow http://doc.php.net/php/dochowto/chapter-conventions.php.

WATCH OUT We should be validating the documentation before checking it
in. http://doc.php.net/php/dochowto/chapter-validating.php

This means make test and make test_xml before checking in.

Speed

If you have used the documentation tools on Windows/Cygwin you will
have learnt how slow they are. They go much faster on Linux even when
running in a VMWare machine. make html for the three SDO sections
takes about 1m 30s on a VMWare-hosted Linux instead of 5 minutes and
upwards on Windows, when running on the same physical machine.



--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"phpsoa" group.
To post to this group, send email to phpsoa@googlegroups.com
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at 
http://groups.google.co.uk/group/phpsoa?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to