Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:89413
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.160.172 as permitted sender)
MIME-Version: 1.0
In-Reply-To: <5655E61E.3000904@gmail.com>
References: <CAJGzsHriGp9PoYq++=CBQptFYZQiAsa+yxxN076BHxMQGD6HrA@mail.gmail.com>
	<5654B516.4020700@gmail.com>
	<CAESVnVpe3+9=N5rkcHp2O5cdGuFnt_EQ=sSV8ucpv5w=ox-NaA@mail.gmail.com>
	<CAJGzsHoP5mc2_demfWM3r7exN4qLThANcbcwo9SBydGpvmB1WQ@mail.gmail.com>
	<5655D82A.8020304@lsces.co.uk>
	<CAJGzsHr3XfxRGA8DSkLzAf-8AQvJPu1GMVE30PX=ScygMPgCPQ@mail.gmail.com>
	<5655E4E4.8070200@garfieldtech.com>
	<5655E61E.3000904@gmail.com>
Date: Wed, 25 Nov 2015 14:53:18 -0200
Message-ID: <CAJGzsHp95tp9kTB14JfUmzZ_tn-1EbD1_p9MCE59GH96AX_5DQ@mail.gmail.com>
To: Rowan Collins <rowan.collins@gmail.com>
Cc: PHP Internals <internals@lists.php.net>
Content-Type: multipart/alternative; boundary=94eb2c07554090d1970525604ba2
Subject: Re: [PHP-DEV] Native Annotation Syntax
From: pedronaroga@gmail.com (Pedro Cordeiro)

--94eb2c07554090d1970525604ba2
Content-Type: text/plain; charset=UTF-8

Rowan, even if they are not harder, there is no reason to keep this feature
in docblocks. Even the argument "compatibility with current
implementations" is flawed, because there are many different
implementations (not only doctrine's) with different syntaxes, so any
native option would break SOME implementations.

Docblocks are Documentation Blocks, which is meant for documentation only.

Mixing documentation (@param) with runtime stuff (@manyToMany) is
counter-intuitive and makes the ecosystem harder to learn.

It's also weird that removing comment blocks break an app.

2015-11-25 14:47 GMT-02:00 Rowan Collins <rowan.collins@gmail.com>:

> Larry Garfield wrote on 25/11/2015 16:42:
>
>> However, doing so would make static checking more difficult; If
>> annotations become a language-native feature, they should be a first-class
>> citizen to make it easier for IDEs to handle.
>>
>
> Could you explain why docblocks are harder to parse than text outside
> docblocks? As far as I know, IDEs *already* parse docblocks, e.g. using
> @param and @return for type analysis, so I don't really see why
> generalising that would be a big problem.
>
>
> --
> PHP Internals - PHP Runtime Development Mailing List
> To unsubscribe, visit: http://www.php.net/unsub.php
>
>

--94eb2c07554090d1970525604ba2--