ID: 35299 Updated by: [EMAIL PROTECTED] Reported By: leonard-php-bugzilla at ottolander dot nl Status: Bogus Bug Type: Documentation problem Operating System: irrelevant PHP Version: Irrelevant New Comment:
And Leonard, you will probably also find out that generating your files from the XML sources of the documentation is a much better idea, as it done by the phpedit.net team for example. Look at: http://www.waterproof.fr/products/PHPEdit/download.php (PHP Functions definition files maker) It works from our XML sources. Previous Comments: ------------------------------------------------------------------------ [2005-11-20 01:47:31] [EMAIL PROTECTED] Of course your help would be appreciated. Read here: http://www.php.net/manual/en/about.howtohelp.php and here http://doc.php.net/php/dochowto/ about that. Yes, I guess it'd be good to have all the docs consistent, so feel free to send your patches to the phpdoc@lists.php.net mailing list. ------------------------------------------------------------------------ [2005-11-20 01:36:03] leonard-php-bugzilla at ottolander dot nl Well, it would be convenient for such purposes as I described. Indeed I see more inconsistencies: ref.tidy.html is ugly as it tags some pseudo constants but not most of the real ones. What's the use of the <TT CLASS="constant"> tag in some pages if it's not used consistently and you don't even want to make an effort to implement this consistently? Who maintains these documentation pages anyway? Can I help? Maybe the consistent use of these tags should be promoted? ------------------------------------------------------------------------ [2005-11-20 01:24:34] [EMAIL PROTECTED] >From what I can see, there are lots of constants that are documented in such way. Look for example at http://www.php.net/manual/en/ref.mysql.php and http://www.php.net/manual/en/ref.network.php . I agree, this is a small incosistency, but this is definitely not a bug, since noone and nowhere told you that all constants will be enclosed with <constant></constant> tag. ------------------------------------------------------------------------ [2005-11-20 01:04:02] leonard-php-bugzilla at ottolander dot nl In table 1 in http://www.php.net/manual/en/ref.pcre.php all the constants in the left column miss these tags. Only the constant mentioned in the right column of the third row is properly tagged. You can compare other pages as well if you need to. ------------------------------------------------------------------------ [2005-11-20 00:47:29] [EMAIL PROTECTED] Which exactly are missing ? ------------------------------------------------------------------------ The remainder of the comments for this report are too long. To view the rest of the comments, please view the bug report online at http://bugs.php.net/35299 -- Edit this bug report at http://bugs.php.net/?id=35299&edit=1
