Re: PHPDoc Standards
| From: | Arnaud Limbourg | Date: | Sun, 11 Aug 2002 08:37:18 +0000 |
| Subject: | Re: PHPDoc Standards | ||
| References: | 1 2 3 4 5 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-8288@lists.php.net to get a copy of this message | ||
> 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?
imho, it is a very good idea to have such a reference. I remember when i first started to write
phpdoc comments, what i did was copy/paste from pear classes ;)
Arnaud.