Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:50215 Return-Path: Mailing-List: contact internals-help@lists.php.net; run by ezmlm Delivered-To: mailing list internals@lists.php.net Received: (qmail 31204 invoked from network); 16 Nov 2010 01:17:17 -0000 Received: from unknown (HELO lists.php.net) (127.0.0.1) by localhost with SMTP; 16 Nov 2010 01:17:17 -0000 X-Host-Fingerprint: 99.38.57.86 adsl-99-38-57-86.dsl.ipltin.sbcglobal.net Received: from [99.38.57.86] ([99.38.57.86:8712] helo=localhost.localdomain) by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP id 30/A5-25603-B9BD1EC4 for ; Mon, 15 Nov 2010 20:17:15 -0500 Message-ID: <30.A5.25603.B9BD1EC4@pb1.pair.com> To: internals@lists.php.net Date: Mon, 15 Nov 2010 20:17:15 -0500 User-Agent: Mozilla/5.0 (Windows; U; Windows NT 6.1; en-US; rv:1.9.2.12) Gecko/20101027 Lightning/1.0b2 Thunderbird/3.1.6 MIME-Version: 1.0 References: <887FE7CFF6F8DE4BB3A9535F53AFD06A2C59B588@il-ex2.zend.net> <887FE7CFF6F8DE4BB3A9535F53AFD06A2C59B6A0@il-ex2.zend.net> <0A.D4.25603.584D1EC4@pb1.pair.com> In-Reply-To: Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Posted-By: 99.38.57.86 Subject: Re: [PHP-DEV] PHP 5.4 - Meta attribute (aka. Annotations) support discussion From: alecgorge@gmail.com (Alec) Mostly it is that a new syntax will confuse people and add complexity that PHP doesn't need. The same people don't believe that annotations bring value worthy of adding a new syntax. Short array notation and similar are noted as precedence. That is a bulk of the arguments, but if I have forgotten any please state them. -Alec On 11/15/2010 7:55 PM, Will Fitch wrote: > Wow. I should actually look at the RFCs more frequently. > > I have to say, assuming the patch is valid for PHP 5.3 (which I have no > doubt it is), I don't see why this can't be taken more seriously. I know > the discussion was brought up a few weeks ago, but what are the objections > to injecting this functionality into the next major post-5.4 release? > > On Mon, Nov 15, 2010 at 6:47 PM, Alec wrote: > >> The patch is already written and a RFC created by Guilherme: >> http://wiki.php.net/rfc/annotations . >> >> I personally think annotations could make a *great* addition to PHP. >> >> I agree with Will that annotations are especially useful for SOAP and >> XML-RPC. I personally think annotations are useful for APIs in general. >> >> Instead of creating a method to respond to a XML-RPC call, then binding it >> to a specific XML-RPC call with a line in the initialization you could just >> do this: >> >> @xmlrpc({ >> name : "server.getValue", >> params : { >> param1 : { >> type : "number", >> docs : "This is documentation for param1" >> } >> } >> }); >> public getValForXMLRPC ($param) { >> ... >> >> I just used JSON for the syntax of annotation. I did this for two reasons: >> 1. most PHP developers can write some Javascript, and 2. since this is >> supposed to avoid syntax discussions, I used a syntax no one uses for >> annotations, but everyone understands. >> >> The possibilities are endless with Annotations and as long as they are >> pretty speedy I think they would be picked up quite quickly and we would get >> some great examples from the community. >> >> My 2 cents. >> >> -Alec >> >> >> On 11/15/2010 6:54 PM, Will Fitch wrote: >> >>> I have certainly wanted them many times - especially when using SOAP. >>> Having WSDL auto-generation without compromising developer >>> documentation and attempting to have user-land code parse phpdoc for this >>> purpose seem{ed,s} counterintuitive. That said, introducing annotations >>> is >>> a HUGE undertaking and would require a ton of work with potentially little >>> return. I do think it would be worth looking into in a future major >>> release, but there are quite a few other things that would be more >>> beneficial to the community for immediate discussions. >>> >>> Did anyone write and RFC on this? guilhermeblanco has a good start. >>> >>> On Mon, Nov 15, 2010 at 5:44 PM, Pierre Joye >>> wrote: >>> >>> On Tue, Nov 16, 2010 at 12:39 AM, Zeev Suraski wrote: >>>> >>>>> Suggesting phpdoc is used for the purposes mentioned does not mean we >>>>> >>>> don't understand what we're talking about. >>>> >>>> I feel like you never used annotations in other languages, did you? >>>> >>>> Cheers, >>>> -- >>>> Pierre >>>> >>>> @pierrejoye | http://blog.thepimp.net | http://www.libgd.org >>>> >>>> -- >>>> PHP Internals - PHP Runtime Development Mailing List >>>> To unsubscribe, visit: http://www.php.net/unsub.php >>>> >>>> >>>> >>> >>> >> >> -- >> PHP Internals - PHP Runtime Development Mailing List >> To unsubscribe, visit: http://www.php.net/unsub.php >> >> > >