Re: Re: PHP Annotations RFC + Patch
| From: | Pierre Joye | Date: | Sun, 12 Sep 2010 12:56:51 +0000 |
| Subject: | Re: Re: PHP Annotations RFC + Patch | ||
| References: | 1 2 3 4 5 6 7 8 9 10 11 12 13 | Groups: | php.internals |
| Request: | Send a blank email to internals+get-49606@lists.php.net to get a copy of this message | ||
Hello Sebastian.
On Sun, Sep 12, 2010 at 2:34 PM, Sebastian Bergmann <sebastian@php.net> wrote:
> On 09/11/2010 02:24 PM, Pierre Joye wrote:
>> It seems that there is a misunderstanding about the goals of the
>> annotations. They are not meant to be read by human being
>> (javadoc/phpdoc/etc. are) but to be parsed automatically to be used
>> for services.
>
> Annotations are part of the code and code is not only automatically
> parsed but also read by humans.
Obviously as they write it. However the primary goal of annotations is
not to be read by human, that's why docs' exist (APIs, inline, etc.).
To make the syntax a pain to parse and make it way too different from
existing annotations syntaxes would not be good.
Cheers,
--
Pierre
@pierrejoye | http://blog.thepimp.net | http://www.libgd.org