Re: [PHP-DOC] Re: doc standards (was: ugly cvs subject :)

2001-12-21 Thread Gabor Hojtsy
I think this need to be discussed. What coding standard would like the phpdoc authors follow, if any. I think we should follow one. Either we choose the PEAR coding standard, which needs to be extended somewhat for our needs (eg. variable names, comment weiting, output sample

Re: [PHP-DOC] Re: doc standards (was: ugly cvs subject :)

2001-12-21 Thread Philip Olson
Following a standard seems logical, following the PEAR coding standard sounds good to me. It's in the manual, makes sense, and is known to many. It is actually not in the manual anymore. PEAR has its own manual now. The PEAR stuff in the main manual is not generated for output. It is

Re: [PHP-DOC] Re: doc standards (was: ugly cvs subject :)

2001-12-20 Thread Philip Olson
Why can't we use the PEAR standard for PHP code and the PECL coding standard (which seem to be the same as the for php) for C related code. It looks confusing and inconsistent when PHP comes along with PEAR and it's conding standard and the Manual with no or another one. I do not say

Re: [PHP-DOC] Re: doc standards (was: ugly cvs subject :)

2001-12-19 Thread Jan Lehnardt
Hi, On Fri, 14 Dec 2001 18:33:36 +0100 Egon Schmid [EMAIL PROTECTED] wrote: From: Gabor Hojtsy [EMAIL PROTECTED] I doesn´ t mean only the space, look at the braces. The question is not only how to write functions, but how to write code, including functions, comments, variable

Re: [PHP-DOC] Re: doc standards (was: ugly cvs subject :)

2001-12-18 Thread Egon Schmid
From: Gabor Hojtsy [EMAIL PROTECTED] Therefore I thought this way of writing the protos is ok. One says care for the pear standards, others say do not. So how should this be done in the future? There must be some standard, we should not let alone all writers IMHO, to write

[PHP-DOC] Re: doc standards (was: ugly cvs subject :)

2001-12-15 Thread Gabor Hojtsy
We must not follow the PEAR standard. Please notice the faqt, that the manual was written before the PEAR coding standards have been written. OK, I think we can get this, as you have written it many times. Then what about developing our own standard for writing code in phpdoc. Are you against

[PHP-DOC] Re: doc standards (was: ugly cvs subject :)

2001-12-14 Thread Gabor Hojtsy
Therefore I thought this way of writing the protos is ok. One says care for the pear standards, others say do not. So how should this be done in the future? There must be some standard, we should not let alone all writers IMHO, to write things in their own preference. We have the

Re: [PHP-DOC] Re: doc standards (was: ugly cvs subject :)

2001-12-14 Thread Gabor Hojtsy
I should know the history. The PEAR standard was written some years after the PHP manual. So I don´t see any improvement if writers should write function_name(args) { // do something } instead of function_name (args) { // do something } Now writers use both. Isn't it better

[PHP-DOC] Re: doc standards (was: ugly cvs subject :)

2001-12-14 Thread Friedhelm Betz
Hi Friday, December 14, 2001, 10:41:50 AM, you wrote: Therefore I thought this way of writing the protos is ok. One says care for the pear standards, others say do not. So how should this be done in the future? There must be some standard, we should not let alone all writers

[PHP-DOC] re: doc standards (was: ugly cvs subject :)

2001-12-12 Thread Gabor Hojtsy
I think we should not put a space after the function name and before the ( char. See the PEAR standards about this thing. That space is used with control structures and functions called without parenthesis (echo, print, include...). This is not a major issue. There was no reaction