Re: cvs: phpdoc / funcindex.xml funclist.txt funcsummary.txt

From: Date: Wed, 02 May 2007 15:19:49 +0000
Subject: Re: cvs: phpdoc / funcindex.xml funclist.txt funcsummary.txt
References: 1 2 3 4  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969376237@lists.php.net to get a copy of this message
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

« previous php.doc (#969376237) next »