Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:49741
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.214.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:from:date:message-id:subject:to
         :cc:content-type;
        b=cnvX2svHV7BarL1OOlKR/20a9MzLQX0zWKcYPMRHIdQ7BjggVoaBhbOqygNjF1F6XJ
         7vHykwGJfg7mEiDLXdy2TUb0CirEiw47jh7atx6ef4N04/++6MHW5Fd/hTd41oSieuS7
         ktZ/j1MRm+EE8cGLaCrSZMBNmyp1s+jRF/I5M=
MIME-Version: 1.0
In-Reply-To: <4C928AD2.9090807@mohiva.com>
References: <AANLkTinGFY8OobnjxEm6EDZyrqrTtvMJdceFMgAcGb7t@mail.gmail.com> <4C928AD2.9090807@mohiva.com>
Date: Thu, 16 Sep 2010 16:25:18 -0700
Message-ID: <AANLkTi=AijNUELY2p0suuuO2iwR1x7efoSCGQZYwm93+@mail.gmail.com>
To: Christian Kaps <christian.kaps@mohiva.com>
Cc: internals@lists.php.net
Content-Type: text/plain; charset=ISO-8859-1
Subject: Re: [PHP-DEV] docBlock Parser RFC
From: chadfulton@gmail.com (Chad Fulton)

Hello!

That is a good point, there would be no file-level doc block in the
RFC. Here is my reasoning for not including it in the RFC:
Since the motivation for this came from the desire for metadata for
PHP structures, it seemed inappropriate to include metadata at the
file level (since it's not a php structure).

As for the @Validator('blahbla'), I had thought it could be replicated with:
/**
 * @Validator blahbla
 */

How to do multiple arguments would be up to user-land functions that
used the parsed doc comments, but one possibility is:
/**
 * @Validator foo bar baz
 */
then when you wanted to retrieve these, you could do explode(' ',
$tags['Validator']); or similar.

However, more specific syntax could be added to allow "arguments" in
the doc block tags. I just feel like in this case absolute simplicity
is important.

Chad

On Thu, Sep 16, 2010 at 2:23 PM, Christian Kaps
<christian.kaps@mohiva.com> wrote:
> Hi Chad,
>
> the RFC looks for me like a built-in PHPDocumentor parser. This can be
> useful. The problem for me is that I cannot parse the file level doc
> block. What is with tags like @Validator('blabla'). I cannot find an
> example for this scenario.
>
> Greetings,
> Christian
>
> --
> PHP Internals - PHP Runtime Development Mailing List
> To unsubscribe, visit: http://www.php.net/unsub.php
>
>