Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:49743 Return-Path: Mailing-List: contact internals-help@lists.php.net; run by ezmlm Delivered-To: mailing list internals@lists.php.net Received: (qmail 31904 invoked from network); 17 Sep 2010 07:45:47 -0000 Received: from unknown (HELO lists.php.net) (127.0.0.1) by localhost with SMTP; 17 Sep 2010 07:45:47 -0000 Authentication-Results: pb1.pair.com header.from=tyra3l@gmail.com; sender-id=pass; domainkeys=bad Authentication-Results: pb1.pair.com smtp.mail=tyra3l@gmail.com; spf=pass; sender-id=pass Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.214.170 as permitted sender) DomainKey-Status: bad X-DomainKeys: Ecelerity dk_validate implementing draft-delany-domainkeys-base-01 X-PHP-List-Original-Sender: tyra3l@gmail.com X-Host-Fingerprint: 209.85.214.170 mail-iw0-f170.google.com Received: from [209.85.214.170] ([209.85.214.170:41322] helo=mail-iw0-f170.google.com) by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP id C5/52-10701-5AC139C4 for ; Fri, 17 Sep 2010 03:45:42 -0400 Received: by iwn37 with SMTP id 37so2096277iwn.29 for ; Fri, 17 Sep 2010 00:45:39 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:mime-version:received:sender:received :in-reply-to:references:date:x-google-sender-auth:message-id:subject :from:to:cc:content-type; bh=BrRsBrImwT8IE3dB8YDVuv27vJpMhqszDKpI3adyps8=; b=HTepg3IOBckJ9DlcaYeyTn28nSAMMmRCIYnRl6apq5F3TdQcFIsPCojR6lWT1FLg7q E0StIlG7OAGloxLHRTfEaGnJydefTwyP9LJCVvP08XGsig1o/rytwyg91NDQ6sYxTNXj Jrni1HqZmPpLJdpcHPXji73envZkDSXLWluaU= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:sender:in-reply-to:references:date :x-google-sender-auth:message-id:subject:from:to:cc:content-type; b=Dw4cyUAr/uKxmZpTZuYV7lAI/rHFAE4U0HSdkn6t+RDvWQSStVYedQe+gy5jPGYM/C SAiois8bblDAT6hKsGN65ZxGUwKe3ZIhQM/6ra73yYnULPY+GLzjxNiUdpRKo8u8u6OD 3wKMHquGy06NSXF94QlAIPzT9FjgVOnnZ3Qzs= MIME-Version: 1.0 Received: by 10.231.190.203 with SMTP id dj11mr4814229ibb.93.1284709538981; Fri, 17 Sep 2010 00:45:38 -0700 (PDT) Sender: tyra3l@gmail.com Received: by 10.231.153.1 with HTTP; Fri, 17 Sep 2010 00:45:38 -0700 (PDT) In-Reply-To: References: Date: Fri, 17 Sep 2010 09:45:38 +0200 X-Google-Sender-Auth: lbKfGYzwiTN1aGlrYcWj0lQAiis Message-ID: To: Chad Fulton Cc: internals@lists.php.net Content-Type: multipart/alternative; boundary=0016364ecc6cb645f004906fbf08 Subject: Re: [PHP-DEV] docBlock Parser RFC From: info@tyrael.hu (Ferenc Kovacs) --0016364ecc6cb645f004906fbf08 Content-Type: text/plain; charset=UTF-8 On Thu, Sep 16, 2010 at 10:56 PM, Chad Fulton 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 > > +1 for this idea. this can be a very useful tool/feature, and can extend the current Reflection support without affecting anything else. but as you and others said we don't have to choose between this feature and the annotation support, because they server different purpose. Tyrael --0016364ecc6cb645f004906fbf08--