On Thu, May 03, 2001 at 12:44:24PM -0600, Andy Sautins wrote:
> 
>    I am working on updating the oci8 extension documentation to reflect some
> new functions that were included.  I have checked out the phpdoc branch and,
> since english is the only language I really know ( sorry ), I'm assuming I'd
> need to make the changes to the en/functions/oci8.xml.

Right!
 
>   My question is, I'd like to iterate a series of change to make sure
> everthing is OK ( I'm new to this whole documentation scheme ).  What is the
> easiest way for me to be able to change the oci8.xml and just
> create/re-create the oci8 section of the documentation?  I'm a little
> confused between the phpdoc/README and phpdoc/README.xsl on what the best
> way of generating the HTML version.

The easiest way is to copy a similar function block and change the content
and let the elements and attributes as is.

To validate your additions, install Jade, DocBook and Norman Walshs
Modular Stylesheets. The components you need are listed somewhere in the
top level directory of phpdoc. It is not so easy to install these
programs. But if you have master this you can try:

autoconf
./configure
make

if there is no error you can look after some time in /html for your newly
functions.

Please use XEmacs if you can, its the best XML-editor I know. There is an
psgml-mode.

-Egon

-- 
LinuxTag, Stuttgart, Germany: July 5-8 2001: http://www.linuxtag.de/
All known books about PHP and related books: http://php.net/books.php 
Concert Band of the University of Hohenheim: http://www.concert-band.de/
First and second bestselling book in German: http://www.php-buch.de/

Reply via email to