Next time, please report the bugs in the PHP bug sytem at:
http://bugs.php.net

Thanks,
Nuno


----- Original Message ----- 
From: "Gaetano Giunta" <[EMAIL PROTECTED]>
To: <[EMAIL PROTECTED]>
Sent: Monday, March 01, 2004 9:34 AM
Subject: [PHP-DOC] Minor glitches the PHP documentation


Hello,

I am in the process of creating a tool to analyze PHP code for OS, webserver
and PHP version compatibility, minimum requirements, do some metric counts
etc... (I did a quick search on Google bot found none).

The starting point would be a PHP function and extension reference table,
which I decided to create by parsing the HTML version of the PHP
documentation (Note: I just discovered today that similar tables do exist
already on the PHP site, albeit not quite up-to-date).

The extrapolation of info from HTML might sound like a dumb idea, but since
I have no intention to dig in the PHP source, it's as close to the real
thing as I could find.

Wading trought the HTML documenattion for tags/specicifc tokens to base my
analysis upon, I found some inconsistencies.
You are free to judge wether these have to be fixed asap or are mere
cosmetic annoyances...

- Function pdf_set_horiz_scaling misses the "Deprecated:" keyword next to
the function name in the first section (before "Description")

- Functions msql_dropdb, msql_freeresult, msql_listdbs, msql_listfields,
msql_listtables, msql_regcase and msql_selectdb miss the "Alias of xxx"
description in the first section

- Function aliases definitions: most of them use "Alias of", while 7
definitions use "Alias for" and one uses "equivalent to"

- The following functions have prototypes where one parameter is described
by type but it misses a name: dbplus_info, dbplus_next, ircg_notice,
qdom_tree

- Functions that take no arguments sometimes have a (void) prototype,
sometimes a () prototype

Thanks
Gaetano Giunta

Reply via email to