Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:49726
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.210.42 as permitted sender)
DomainKey-Status: bad
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=message-id:date:from:user-agent:mime-version:to:cc:subject
         :references:in-reply-to:content-type:content-transfer-encoding;
        b=qr2gBeg5lLmKvac38NFiy8dCXGCo0IcPFa1WCLVBdtHv2z23vTRIZPdHgxsFwciz6m
         P9N9vHUUVIDptxYvvxyERx17CJW0gpLg3/TcByFXEzh+muvCD42fofggMwH4UG5A9syc
         adCQz9cImdKk9sW+kczT/uqtZuPaqpdYW9qk4=
Message-ID: <4C926BC8.8060206@gmail.com>
Date: Thu, 16 Sep 2010 12:11:04 -0700
User-Agent: Mozilla/5.0 (X11; U; Linux x86_64; en-US; rv:1.9.1.12) Gecko/20100826 Thunderbird/3.0.7
MIME-Version: 1.0
To: Stas Malyshev <smalyshev@sugarcrm.com>
CC: Guilherme Blanco <guilhermeblanco@gmail.com>, 
 Gustavo Lopes <glopes@nebm.ist.utl.pt>,
 Derick Rethans <derick@php.net>, 
 "internals@lists.php.net" <internals@lists.php.net>
References: <AANLkTimuWDV=9AA63_9M6cQSp9riCPE214sUNdoV3tQn@mail.gmail.com>	<4C873C0F.1010200@zend.com>	<AANLkTimdCnW3ABq5QSnBa78H14e2LPBa=Kt2txU0sTD4@mail.gmail.com>	<4C879613.7090709@zend.com>	<AANLkTim-dHYyJxX2R3-PBVqqa3sv3+zKYr7zw7QvyngJ@mail.gmail.com>	<4C887D2B.2000605@zend.com>	<4C8AC526.7000505@sugarcrm.com>	<AANLkTikpCGj2zVNQmC1gUWaRSpsQD=qNrETi90wj_No7@mail.gmail.com>	<4C8B6168.30504@mohiva.com>	<AANLkTinuD_Aga-CbsbSq-23MTyOLPGrBEswTm=JtBY0H@mail.gmail.com>	<4C8BC81E.8000605@sugarcrm.com>	<AANLkTinFSqCFUE3P5XvjJPwUGZqYrQR_9VHAXAWSL=rv@mail.gmail.com>	<7.0.1.0.2.20100913145703.0d226d90@zend.com>	<alpine.DEB.2.00.1009161454590.24012@kossu.derickrethans.nl>	<op.vi4pwzpsidpuyk@cataphract-old.dulce.lo.geleia.net> <AANLkTimwXKohy_ai1+ZWsUghkwgzcL=kT8dBi25oGcrZ@mail.gmail.com> <4C926574.8030805@sugarcrm.com>
In-Reply-To: <4C926574.8030805@sugarcrm.com>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit
Subject: Re: [PHP-DEV] Re: PHP Annotations RFC + Patch
From: paul.crovella@gmail.com (Paul)

On 09/16/2010 11:44 AM, Stas Malyshev wrote:
> Hi!
> 
>> Again, we should not consider docblock mainly because I think
>> adding/removing comments of your code should NEVER modify the overall
>> functionality of your application.
> 
> It's a circular argument - "we can't use docblocks because docblocks
> shouldn't be used". They are not "comments" if you don't use them as
> comments.

Overloading comment syntax to modify application functionality is the
worst idea I've seen suggested on this list. This beats goto by miles.

We would then need a new comment syntax to comment out annotations. Just
for annotations.

Adding/removing/changing comments suddenly has an impact on
functionality. Sometimes. If the comment is really an annotation.
Despite it looking exactly like comments have looked for years.

"Why's my stuff broke? That stack trace leads me through... a
docblock?!? Wait, that comment I updated wasn't really a comment, it
just looked like one? Oh hell, that other comment I added got mistaken
for an annotation? WTF?"

This is supposed to be *less* confusing for people?