method synopsis formatting
| From: | Horst Schirmeier | Date: | Sat, 08 Jan 2005 02:04:50 +0000 |
| Subject: | method synopsis formatting | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969365862@lists.php.net to get a copy of this message | ||
Hi,
the following only deals with a minor formatting issue, which
nevertheless disturbs me for quite a while.
I suggest changing the method synopsis formatting in the docs from
(example; note the whitespace around the first parenthesis):
mixed array_search ( mixed needle, array haystack [, bool strict])
to some PEAR coding standards conform:
(1)
mixed array_search(mixed needle, array haystack [, bool strict])
or a maybe better readable:
(2)
mixed array_search (mixed needle, array haystack [, bool strict])
I'd still prefer the first proposal. Opinions? Please comment, I won't
commit this without some backing as it will change the overall look of
php.net/manual.
Below my current cvs diff which (hopefully) implements (1); did I miss
something?
Regards,
Horst Schirmeier
--
PGP-Key 0xD40E0E7A