Re: html Documentation

[Nigel S. <nig...@us...>]

> Much improved - many thanks. A couple of small points:
>
> 1. the sample code at the end of the php file does not appear in the html
(or
> xml) documentation, so the usage text isn't correct :-)

The documentation is all automatically built from the php source file using
a perl script.  The sample usage appears at the end of the php file, but not
the xml/html file, and the perl script doesn't parse out the example test
script.  I've altered the comment in the php file to help to indicate that
the usage is not in the .html file.

I want the GeneratePhpDocumentation.pl script to be as generic as possible,
so I am very reluctant to alter it to pick out the sample usage as well to
put in the .html doc.

> 2. the internal links in the html file have never worked and I've just
> investigated why. The # should be removed from all the names in the
anchors -
> <a name="function"> not <a name="#function"> Fixing this (looks like this
is
> in the xslt script) would make the html documentation much easier to use
> :-)

Ah thanks.  IE wasn't bothered by this, so I hadn't noticed.  Have updated
the XSL.

Nigel