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

Reply via email to