Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:49606 Return-Path: Mailing-List: contact internals-help@lists.php.net; run by ezmlm Delivered-To: mailing list internals@lists.php.net Received: (qmail 45772 invoked from network); 12 Sep 2010 12:56:54 -0000 Received: from unknown (HELO lists.php.net) (127.0.0.1) by localhost with SMTP; 12 Sep 2010 12:56:54 -0000 Authentication-Results: pb1.pair.com smtp.mail=pierre.php@gmail.com; spf=pass; sender-id=pass Authentication-Results: pb1.pair.com header.from=pierre.php@gmail.com; sender-id=pass; domainkeys=bad Received-SPF: pass (pb1.pair.com: domain gmail.com designates 74.125.82.54 as permitted sender) DomainKey-Status: bad X-DomainKeys: Ecelerity dk_validate implementing draft-delany-domainkeys-base-01 X-PHP-List-Original-Sender: pierre.php@gmail.com X-Host-Fingerprint: 74.125.82.54 mail-ww0-f54.google.com Received: from [74.125.82.54] ([74.125.82.54:41794] helo=mail-ww0-f54.google.com) by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP id 1E/52-17717-51ECC8C4 for ; Sun, 12 Sep 2010 08:56:54 -0400 Received: by wwb39 with SMTP id 39so2775929wwb.11 for ; Sun, 12 Sep 2010 05:56:51 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:mime-version:received:received:in-reply-to :references:date:message-id:subject:from:to:cc:content-type :content-transfer-encoding; bh=VWIpi4De4EqRrOV1sRwDywC+9pX0oQQzaZ7xmBAl4G4=; b=eIWOIg+M82YW+Olr48wa7TZtogJUdPz4WEFwbkpQDyuDazrkj1fKX3NBvyM7ft1GeK NbDh99Z86yRFxC0sJh3Y4aHxt5XsFBugVcIfL/QP1XTcQpp15GgOMVLQToxLcURY9yVT We7HyNuOvLzYlQEhmyKE52QCFr+uKVjNah3JI= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type:content-transfer-encoding; b=RrpKjdL8NGhWcwTNQnCRvzjlC7ZIz3o1BSygl3G0Z+3k/mjhPE2Nd/GATJzw3LNSFJ zWXaltCWXPbYTu5txyN2KiSDSu3ZBzgx0/B7QVg9uhk+GaOgMSXJVF7xHHjHmtfJh5Yi Jv5jgaPk0CqModVZz6I1wtVj6w7fhxYyRB93o= MIME-Version: 1.0 Received: by 10.227.134.129 with SMTP id j1mr370890wbt.79.1284296211101; Sun, 12 Sep 2010 05:56:51 -0700 (PDT) Received: by 10.227.149.220 with HTTP; Sun, 12 Sep 2010 05:56:51 -0700 (PDT) In-Reply-To: <4C8CC8E8.3060104@php.net> References: <4C873C0F.1010200@zend.com> <4C879613.7090709@zend.com> <4C887D2B.2000605@zend.com> <4C8AC526.7000505@sugarcrm.com> <4C8B6168.30504@mohiva.com> <4C8BC81E.8000605@sugarcrm.com> <4C8CC8E8.3060104@php.net> Date: Sun, 12 Sep 2010 14:56:51 +0200 Message-ID: To: Sebastian Bergmann Cc: internals@lists.php.net Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable Subject: Re: [PHP-DEV] Re: PHP Annotations RFC + Patch From: pierre.php@gmail.com (Pierre Joye) Hello Sebastian. On Sun, Sep 12, 2010 at 2:34 PM, Sebastian Bergmann wro= te: > On 09/11/2010 02:24 PM, Pierre Joye wrote: >> It seems that there is a misunderstanding about the goals of the >> annotations. They are not meant to be read by human being >> (javadoc/phpdoc/etc. are) but to be parsed automatically to be used >> for services. > > =A0Annotations are part of the code and code is not only automatically > =A0parsed but also read by humans. Obviously as they write it. However the primary goal of annotations is not to be read by human, that's why docs' exist (APIs, inline, etc.). To make the syntax a pain to parse and make it way too different from existing annotations syntaxes would not be good. Cheers, --=20 Pierre @pierrejoye | http://blog.thepimp.net | http://www.libgd.org