Re: PHPDoc Standards
| From: | Ant�nio" Carlos "Ven�ncio" "J�nior | Date: | Sun, 11 Aug 2002 00:34:22 +0000 |
| Subject: | Re: PHPDoc Standards | ||
| References: | 1 2 3 4 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-8286@lists.php.net to get a copy of this message | ||
Alexander,
alexander.merz@t-online.de (Alexander Merz) wrote:
| The idea of the PHPDoc-Part of the manual was to give the PEAR-Devils a
|
| reference, as fast as writable. I know there are some missing - they
| are (excl. @return) not really required for the typical PEAR functions
| docs or PHP 4 in general.
But the idea is to have a PHPDoc grammar. So we need some place (like
the Ulf's slides) that explain how to make the comments.
And PHPDoc is assumed to be used in other circunstances besides PEAR. We
need to know what kind of tags developers need and add support for them
in PHPDoc and make documentation about all tags.
The page could be something like the JavaDoc one:
----------
http://java.sun.com/j2se/javadoc/writingdoccomments/index.html
----------
What do you think?
Até
Antônio
"Can't buy what I want because its FREE!" - Pearl Jam
floripa@PHP.net | PHP & FreeBSD & MySQL | PGP Key ID 0x5BBEB073
Attachment: [application/pgp-signature]
Attachment: [application/pgp-signature]