[PHP-DOC] Ideas to Php.net

2010-02-10 Thread Jesús Cova
Good afternoon, i'm writting you because i propose some ideas that i want to work in PHP.net if you allow me. Mr. Magnusson wrote me that i must write to this email to notify it, i want to improve the tutorials part, i want to become it more friendly and understable to those persons which started t

[PHP-DOC] Ideas to Php.net

2010-02-10 Thread Jesús Cova
Good afternoon, i'm writting you because i propose some ideas that i want to work in PHP.net if you allow me. Mr. Magnusson wrote me that i must write to this email to notify it, i want to improve the tutorials part, i want to become it more friendly and understable to those persons which started t

Re: [PHP-DOC] How far do/should we go in documenting defaults in the prototype?

2010-02-10 Thread Richard Quadling
On 10 February 2010 15:16, Christopher Jones wrote: > > > Richard Quadling wrote: >> >> Hi. >> >> With substr_compare, the prototype should say ... >> >> int substr_compare ( string $main_str , string $str , int $offset [, >> int $length = max(strlen($str), strlen($main_str) - $offset) [, bool >>

Re: [PHP-DOC] How far do/should we go in documenting defaults in the prototype?

2010-02-10 Thread Christopher Jones
Richard Quadling wrote: Hi. With substr_compare, the prototype should say ... int substr_compare ( string $main_str , string $str , int $offset [, int $length = max(strlen($str), strlen($main_str) - $offset) [, bool $case_insensitivity = false ]] ) which looks a little complex, even when sty

[PHP-DOC] How far do/should we go in documenting defaults in the prototype?

2010-02-10 Thread Richard Quadling
Hi. With substr_compare, the prototype should say ... int substr_compare ( string $main_str , string $str , int $offset [, int $length = max(strlen($str), strlen($main_str) - $offset) [, bool $case_insensitivity = false ]] ) which looks a little complex, even when styled appropriately. I think