> >   Modified files:
> >     /phpdoc   funcindex.xml funcsummary.txt funclist.txt
> >   Log:
> >   Updated funcindex.xml funcsummary.txt funclist.txt
> >   No ZendAPI and no PECL entries.
>
> Hello Richard,
>
> Why did you remove the PECL entries?

If you take the Cairo PECL extension (as an example), there is no
mention of this within the  online PHP manual.

http://www.php.net/manual-lookup.php?pattern=cairo&lang=en

reveals no cairo.

So, I assume that the --with-pecl-source option is not used to build
the online documentation.

So I turned it off on my local build and did the same.

I also turned off --with-source and --with-pear-source.

This stops any of the ZendAPI stuff which I previously polluted these
files with.

Should PECL documentation be included?

Richard.

What I failed to say just above was with the --with-pecl-source option
enabled, you do get a whole load of additional documentation and
functions (Cairo, html-parse, libexif, mdbtools and uuid).

But none of these are in the standard documentation, so the standard
files (quickref.txt, funclist.txt, funcsummary.txt and funcindex.xml)
now reflect the standard way of doing things.

And also updates the PDF extension to reflect additional functions and
deprecated functions.

Not every function is documented but that's slowly changing. All PECL
extensions are documented within the PHP Manual, well, they all should
be or at least will be. Many already are and are now missing from these
files while some are in the files because they are symlinked from within
php-src but that's another story...

Regards,
Philip

Reply via email to