RE: [PEAR-DOC] new tag needed?
| From: | Lukas Smith | Date: | Tue, 14 Jan 2003 16:30:29 +0000 |
| Subject: | RE: [PEAR-DOC] new tag needed? | ||
| References: | 1 | Groups: | php.pear.doc |
| Request: | Send a blank email to pear-doc+get-277@lists.php.net to get a copy of this message | ||
> -----Original Message-----
> From: Pierre-Alain Joye [mailto:paj@pearfr.org]
> Sent: Tuesday, January 14, 2003 4:02 PM
> To: Lukas Smith
> Cc: greg@chiaraquartet.net; pear-doc@lists.php.net
> Subject: Re: [PEAR-DOC] new tag needed?
> > Hmm I would prefer to stick with @category and rather add a new tag
> > @repository.
>
> Does that not create a conflict (confusions) between the cvs
repository
> category and pearweb category ? I think the pearweb category is what
we
> need for this tag, so @pear_category should do it.
I think it pollutes the phpdoc standard if we start adding pear specfic
tags.
@category was introduced to help peardoc2 figure out which pear category
the package was meant for.
This could be useful for other repositories as well.
If we also want to allow people to tag what repository the category
belongs to then I would recommend a @repository tag.
@pear* is ugly, nasty, hacky and the first step down the road of
polluting the phpdoc syntax into oblivion. PHPDoc has nothing to do at
all with PEAR. PEAR is just one project that uses phpdoc.
Regards,
Lukas