Re: PHPDoc ... Problem is in PEAR-Classes

From: Date: Thu, 21 Nov 2002 21:36:09 +0000
Subject: Re: PHPDoc ... Problem is in PEAR-Classes
References: 1 2  Groups: php.pear.general 
Request: Send a blank email to pear-general+get-2796@lists.php.net to get a copy of this message
Tobias Schlitt wrote: phpDocumentor will provide error reports on problems with documentation. When parsing pear i've noticed that lots of people make up there own tags or syntax. If you want to work on getting the errors fixed i can send you an error report. Of course this doesn't cover all cases just thing like using non-existent tags or adding a colon etc. -joshua eichorn
Tobias Schlitt <toby@php.net> artikulierte:
Hi y'all! I got some problems while parsing the PEAR-Classes (mainly all, since beta-stadium) with the PHPDoc. Many classes got parsed well, but many times, it does not get the documentation of anything. (e.g. Net/POP3) Here is the Code from the PHP3-Class: [...]
I tried fixin the "/*"-Beginnings of documentation to "/**" as needed by the PHPDoc and PHPDocumentor. That's the point. Many inline-code-docs in PEAR are not introduced correctly. I fixed that now with preg_replace() through all files in PEAR. But that's not really great. I thought, that the classes in PEAR should all fit PEARs code-conventions. What do you think??


« previous php.pear.general (#2796) next »