Re: cvs: php4 /ext/fdf fdf.c php_fdf.h
| From: | Jani Taskinen | Date: | Sat, 07 Apr 2001 01:50:55 +0000 |
| Subject: | Re: cvs: php4 /ext/fdf fdf.c php_fdf.h | ||
| References: | 1 | Groups: | php.cvs |
| Request: | Send a blank email to php-cvs+get-5020@lists.php.net to get a copy of this message | ||
On Sat, 7 Apr 2001 eschmid+sic@s.netic.de wrote:
>Why are you changing in the describtions of protos "Sets" to "Set",
>"Adds"
>to "Add" and so on? I think the former was the right english description.
>Please look into CODING_STANDARDS at php.net and phpdoc/funcsummary.txt.
hmm..well, I checked the documentation and there they seem to be
differently written. And it seems our 'example' code, mysql extension,
doesn't follow these standards either.
>Notice also, some people are adding a punctuation mark, which looks bad. I
>hope Rasmus will give some advice, how we should do this in the future.
Ok.
>I have just reread that small chapter "Documentation and Folding Hooks" in
>CODING_STANDARDS. Compare the two examples and you know what I am speaking
>off (add a "s" to Return in the first example and remove the punctuation
>mark in the second example).
Eh..that 'standard' seems to suggest two different ways of doing it.. :)
--Jani