#35299 [Bgs]: Missing <TT CLASS="constant"> tags in ref.pcre.html
| From: | leonard-php-bugzilla at ottolander dot nl | Date: | Sun, 20 Nov 2005 15:11:32 +0000 |
| Subject: | #35299 [Bgs]: Missing <TT CLASS="constant"> tags in ref.pcre.html | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969370951@lists.php.net to get a copy of this message | ||
ID: 35299
User updated by: leonard-php-bugzilla at ottolander dot nl
Reported By: leonard-php-bugzilla at ottolander dot nl
Status: Bogus
Bug Type: Documentation problem
Operating System: irrelevant
PHP Version: Irrelevant
New Comment:
Please ignore that last remark ;) . That page actually does have a
pointer to the anonymous CVS account name.
Previous Comments:
------------------------------------------------------------------------
[2005-11-20 16:09:24] leonard-php-bugzilla at ottolander dot nl
I was already wondering what to create patches against. It seems a bit
silly to supply patches against the html pages if these pages are
generated from another source (XML).
What username
Wshould I use to do anonymous checkouts? anoncvs, anon, anonymous,
nobody, all don't seem to work. Sadly this is not mentioned at
http://doc.php.net/php/dochowto/chapter-cvs.php
.
------------------------------------------------------------------------
[2005-11-20 11:02:27] goba@php.net
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.
------------------------------------------------------------------------
[2005-11-20 01:47:31] tony2001@php.net
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] tony2001@php.net
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.
------------------------------------------------------------------------
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