Re: [PHP-DOC] Re: [PHP-DEV] Re: [PHP-DOC] Improving the documentation

2007-02-10 Thread Philip Olson
On Feb 10, 2007, at 8:38 AM, Rasmus Lerdorf wrote: We, and by we I mean all of us who write code and hope that divine intervention will take care of the documentation, need to do a better job helping out divinity. A DOC tag in cvs commit messages seems like a small and easy thing for us to a

[PHP-DOC] cvs: phpdoc /en/reference/info/functions getenv.xml

2007-02-10 Thread TAKAGI Masahiro
takagi Sun Feb 11 05:04:12 2007 UTC Modified files: /phpdoc/en/reference/info/functions getenv.xml Log: correct role. http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/info/functions/getenv.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc/en/reference/info/fu

[PHP-DOC] Re: [PHP-DEV] Re: [PHP-DOC] Improving the documentation

2007-02-10 Thread Richard Lynch
On Sat, February 10, 2007 5:41 am, Ronald Chmara wrote: > Scenario one: > All behavior changes must be documented, this tag is always there, > and thus not useful. I beg to differ. If every change was documented to the degree that it needed documentation, the tag would be useful still: USEFUL: -

Re: [PHP-DOC] Re: [PHP-DEV] Re: [PHP-DOC] Improving the documentation

2007-02-10 Thread Etienne Kneuss
Hi, I also made a mailing list scanner[1] that fills a DB on doc.php.net. Every entries can then be commented, tagged as TODO etc... The scanner itself is ready, the interface still need some work. Maybe a mix of both ? [1] http://colder.ch/repository/php/php.net/cvslogger.php Wez Furlong wr

Re: [PHP-DOC] Re: [PHP-DEV] Re: [PHP-DOC] Improving the documentation

2007-02-10 Thread Wez Furlong
I tweaked loginfo.pl so that if the commit message contains [DOC], phpdoc@ will be Cc'd. Hopefully that'll help in some small way. --Wez. On 2/10/07, Rasmus Lerdorf <[EMAIL PROTECTED]> wrote: We, and by we I mean all of us who write code and hope that divine intervention will take care of the d

[PHP-DOC] Re: [PHP-DEV] Re: [PHP-DOC] Improving the documentation

2007-02-10 Thread Lukas Kahwe Smith
Rasmus Lerdorf wrote: Perhaps we can do more though. Maybe you guys could periodically update internals on problem areas in the docs. Places where you feel things are vague and really could use the guy who wrote the code to get off his ass and explain how it works. Or maybe we could get every

[PHP-DOC] Re: [PHP-DEV] Re: [PHP-DOC] Improving the documentation

2007-02-10 Thread Rasmus Lerdorf
We, and by we I mean all of us who write code and hope that divine intervention will take care of the documentation, need to do a better job helping out divinity. A DOC tag in cvs commit messages seems like a small and easy thing for us to add to the process, so if you feel that will be enough to

[PHP-DOC] #40405 [Opn->Csd]: htmlentities example is incorrect.

2007-02-10 Thread colder
ID: 40405 Updated by: [EMAIL PROTECTED] Reported By: ar3121 at att dot com -Status: Open +Status: Closed Bug Type:Documentation problem PHP Version: Irrelevant -Assigned To: +Assigned To: colder New Comment: This bug has been fixed in the documentation's XML sources.

[PHP-DOC] cvs: phpdoc /scripts html_syntax.php

2007-02-10 Thread Etienne Kneuss
colder Sat Feb 10 11:42:27 2007 UTC Modified files: /phpdoc/scripts html_syntax.php Log: - remove entities decoding - Fix #40405 (htmlentities example) - Fix htmlspecialchars example http://cvs.php.net/viewvc.cgi/phpdoc/scripts/html_syntax.php?r1=1.13&r

Re: [PHP-DOC] Improving the documentation

2007-02-10 Thread Ronald Chmara
On Jan 27, 2007, at 8:26 AM, Mehdi Achour wrote: Hello internals, I've been helping with PHP documentation for 4 years now, and I still can't help the fact that a lt of things are not documented, that our/my way of handling the PHP documentation update is not accurate, nor productive, n