Re: Re[2]: [PHP-DOC] Re: PHP Function List

From: Date: Sat, 17 Mar 2007 00:32:13 +0000
Subject: Re: Re[2]: [PHP-DOC] Re: PHP Function List
References: 1 2 3 4 5 6 7  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969375791@lists.php.net to get a copy of this message
What is wrong with the scripts and generated content?
Some output is incorrect, see below:
quickref.txt is generated from manual.xml via XSLT and I am pretty sure it doesn't contain any errors.
It contains all the Zend API stuff including macros, so all these end up in funcindex.xml as well. Maybe have the script take into account the INTERNALS_EXCL_* inside manual.xml
genfunclist.php and hence funclist.txt is much better than awk scripts provided before - you may annotate makefile and extract them from attic to compare as it said in commit comments for the script.
This one isn't that bad, in fact, it might be perfectly valid output. Please I'd rather not touch the awk script or even look at it... we'll never never ever go back to those! But over time bugs have been introduced mainly due to changes made elsewhere in both php src and php doc. At least I assume this is why some bugs now exist in these scripts.
genfuncsummary.php - perhaps I was running out of time to finish testing of this one, but I've added it to makefile, so it should be better as well. In any case - awk scripts are still present and it will not take too much time to annotate makefile and find command line used to launch them to see which result is better
Examples from the output: avoid php_snmpv3(INTERNAL_FUNCTION_PARAMETERS, int st) * * Generic SNMPv3 object fetcher * From here is passed on ... void DOMAttr::__construct(string name, [string value]) U */ PHP_METHOD(domattr, __construct) { zval *id; xmlAttrPtr ... apache_request_basic_auth_pw() */ PHP_FUNCTION(apache_request_basic_auth_pw) { zval * .... Other Notes: At some point we need to come up with one solid method for sifting through php-src because currently we do it so many ways... See also check-references.php and functable.php Regards, Philip

« previous php.doc (#969375791) next »