Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:49738
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 74.125.82.170 as permitted sender)
DomainKey-Status: bad
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=mime-version:in-reply-to:references:date:message-id:subject:from:to
         :cc:content-type;
        b=TD4Kry567P0d9qeTfL9Lq/GjahOxLYjrI+KaFDZLTMZaHmeg9FqrDKsUb722OIVaxH
         lJG/7RKSPhi3Rxll2w4DGTBjGXuNSXEH3OSgPrBLH7MDvNyt7eLBVhNsCKVEo2F3Z1AX
         dDUpes6E10U/ViVs5Nupkf2mNspJ3/a3kq0QM=
MIME-Version: 1.0
In-Reply-To: <AANLkTinGFY8OobnjxEm6EDZyrqrTtvMJdceFMgAcGb7t@mail.gmail.com>
References: <AANLkTinGFY8OobnjxEm6EDZyrqrTtvMJdceFMgAcGb7t@mail.gmail.com>
Date: Thu, 16 Sep 2010 23:38:38 +0200
Message-ID: <AANLkTimM3k52De-ARdfKP0akxUYwMqq0X_6hfTghv6JQ@mail.gmail.com>
To: Chad Fulton <chadfulton@gmail.com>
Cc: internals@lists.php.net
Content-Type: text/plain; charset=ISO-8859-1
Subject: Re: [PHP-DEV] docBlock Parser RFC
From: pierre.php@gmail.com (Pierre Joye)

hi,

That's nice a nice idea. The PHPDocumentator guys did something to
help the parsing via a pecl's extension
(http://pecl.php.net/docblock). Now, to implement the docbloc parsing
itself will require a parser usage (lemon or whatever else you want),
it will be freaking tricky, not necessary fast and very hard to be
interpreted by computers being. By the way, that's why annotations
exist and why annotations have new, smaller, easier to parse syntax.

Cheers,

On Thu, Sep 16, 2010 at 10:56 PM, Chad Fulton <chadfulton@gmail.com> wrote:
> Hello,
>
> Based on comments from the annotations thread, I have created a
> docBlock parser RFC at http://wiki.php.net/rfc/docblockparser
>
> This RFC does not deal with annotations per se, but only with the idea
> of adding a function to the Reflection extension which would parse
> docBlocks according to a set docBlock syntax into a simple associative
> array containing three elements: short description, long description,
> and an array of tags.
>
> This is only meant to aid meta-data retrieval for classes and does not
> automatically instantiate anything objects.
>
> The RFC was meant to conform to existing convention on the formatting
> of docBlocks - so one major way to improve it would be to note any
> inconsistencies with accepted practice.
>
> Feel free to improve in any other way as well, of course.
>
> Thanks,
> Chad
>
> --
> PHP Internals - PHP Runtime Development Mailing List
> To unsubscribe, visit: http://www.php.net/unsub.php
>
>



-- 
Pierre

@pierrejoye | http://blog.thepimp.net | http://www.libgd.org