Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:92973 Return-Path: Mailing-List: contact internals-help@lists.php.net; run by ezmlm Delivered-To: mailing list internals@lists.php.net Received: (qmail 94488 invoked from network); 30 Apr 2016 08:52:59 -0000 Received: from unknown (HELO lists.php.net) (127.0.0.1) by localhost with SMTP; 30 Apr 2016 08:52:59 -0000 Authentication-Results: pb1.pair.com smtp.mail=lester@lsces.co.uk; spf=permerror; sender-id=unknown Authentication-Results: pb1.pair.com header.from=lester@lsces.co.uk; sender-id=unknown Received-SPF: error (pb1.pair.com: domain lsces.co.uk from 217.147.176.214 cause and error) X-PHP-List-Original-Sender: lester@lsces.co.uk X-Host-Fingerprint: 217.147.176.214 mail4-2.serversure.net Linux 2.6 Received: from [217.147.176.214] ([217.147.176.214:40911] helo=mail4.serversure.net) by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP id E3/B4-58459-96274275 for ; Sat, 30 Apr 2016 04:52:59 -0400 Received: (qmail 32018 invoked by uid 89); 30 Apr 2016 08:52:55 -0000 Received: by simscan 1.3.1 ppid: 32010, pid: 32015, t: 0.0887s scanners: attach: 1.3.1 clamav: 0.96/m:52/d:10677 Received: from unknown (HELO ?10.0.0.7?) (lester@rainbowdigitalmedia.org.uk@81.138.11.136) by mail4.serversure.net with ESMTPA; 30 Apr 2016 08:52:54 -0000 To: internals@lists.php.net References: <5719CDB2.90103@zend.com> <571DCA6A.2070803@zend.com> <571E35D8.8080504@zend.com> <571E4A83.3080304@garfieldtech.com> <571E64A2.2040505@gmail.com> <5720A6B4.4000307@lsces.co.uk> <5721B9DD.3050300@lsces.co.uk> <57231ADD.9040006@lsces.co.uk> Message-ID: <57247266.9050609@lsces.co.uk> Date: Sat, 30 Apr 2016 09:52:54 +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: Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit Subject: Re: [PHP-DEV] PHP Attributes -> docBloc alternatives ... From: lester@lsces.co.uk (Lester Caine) On 30/04/16 09:38, Pierre Joye wrote: >> Sorry if you didn't spend the last 6+ years of your free time >> > < > https://github.com/phpDocumentor/phpDocumentor2/commit/66dc9069085dcea957508f84e9c79eaf4c234586 >> > >> > (yes, that is an import) maintaining an open-source project focused on >> > annotations-based documentation. > This is not what it does (or I hope it does not). And it makes me sigh to > read such descriptions. Annotations or attributes are not documentations. > For the record for this thread :) It was the use of the 'standard' defined by phpDocumentor2 to 'define' php-annotations that trigger my current noise, but while I agree with you, the information contained in what ever method is used to add 'attributes' to the 'annotations' also forms a useful part of any documentation. In my book the two go hand in hand. Which is why I changed the title of the thread. -- 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