Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:92854
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: error (pb1.pair.com: domain lsces.co.uk from 217.147.176.214 cause and error)
To: internals@lists.php.net
References: <57211D05.6020002@fleshgrinder.com>
Message-ID: <572130DB.3020503@lsces.co.uk>
Date: Wed, 27 Apr 2016 22:36:27 +0100
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:38.0) Gecko/20100101
 Thunderbird/38.7.0
MIME-Version: 1.0
In-Reply-To: <57211D05.6020002@fleshgrinder.com>
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit
Subject: Re: [PHP-DEV] [RFC] PHP Annotations VS Attributes
From: lester@lsces.co.uk (Lester Caine)

On 27/04/16 21:11, Fleshgrinder wrote:
> It is about natural language, proper computer
> science terminology, and what PHP users will search for in search
> engines.

To add to your list ...
https://www.phpdoc.org/docs/latest/guides/docblocks.html

The glossary entry is rather bare, but I would dispute THEIR statement -
"but also influences the way the application behaves."

In my book, these comment blocks are 'annotation' is it's simplest form,
and we add tags within that annotation to make particular details of
that annotation both machine readable and humanly prominent. That some
of these keys may be used to "influences the way the application
behaves." is secondary?

My continuing irritation is that while subsets keep getting discussed as
duplicate elements outside of the phpdoc wrapper, there is no provision
for the annotations that would actually help data validation.

-- 
Lester Caine - G8HFL
-----------------------------
Contact - http://lsces.co.uk/wiki/?page=contact
L.S.Caine Electronic Services - http://lsces.co.uk
EnquirySolve - http://enquirysolve.com/
Model Engineers Digital Workshop - http://medw.co.uk
Rainbow Digital Media - http://rainbowdigitalmedia.co.uk