Notes refsect1, langref=>language
| From: | Aidan Lister | Date: | Mon, 24 Jan 2005 15:57:49 +0000 |
| Subject: | Notes refsect1, langref=>language | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969366151@lists.php.net to get a copy of this message | ||
First up, we need a notes refsect1.
I redid the empty() manual page today, and decided that we definitely need a
"Notes" section for things that just don't fit anywhere else.
http://livedocs.homelinux.com/en/function.empty.html
Is there any opposition to creating this?
I'm not sure where I'd incorporate the notes on pages like stream_select
(vast number of warnings/notes/cautions) either.
Secondly,
Are there any problems with changing the <part id="langref"> to <part
id="language"> in manual.xml.in? It makes sense, as all the children
sections are prefixed with "language." and not "langref.". If this is done,
a patch for errors.php should be included too.
Best wishes,
Aidan