Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:92835 Return-Path: Mailing-List: contact internals-help@lists.php.net; run by ezmlm Delivered-To: mailing list internals@lists.php.net Received: (qmail 3136 invoked from network); 27 Apr 2016 11:47:07 -0000 Received: from unknown (HELO lists.php.net) (127.0.0.1) by localhost with SMTP; 27 Apr 2016 11:47:07 -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:34108] helo=mail4.serversure.net) by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP id 17/34-20013-8B6A0275 for ; Wed, 27 Apr 2016 07:47:04 -0400 Received: (qmail 15993 invoked by uid 89); 27 Apr 2016 11:47:00 -0000 Received: by simscan 1.3.1 ppid: 15987, pid: 15990, t: 0.0838s 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; 27 Apr 2016 11:47:00 -0000 To: internals@lists.php.net References: <571965D1.9020102@zend.com> <5719CDB2.90103@zend.com> <571DCA6A.2070803@zend.com> <571E35D8.8080504@zend.com> <571E4A83.3080304@garfieldtech.com> <571E64A2.2040505@gmail.com> Message-ID: <5720A6B4.4000307@lsces.co.uk> Date: Wed, 27 Apr 2016 12:47:00 +0100 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:38.0) Gecko/20100101 Thunderbird/38.5.0 MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit Subject: PHP Attributes -> docBloc alternatives ... From: lester@lsces.co.uk (Lester Caine) On 25/04/16 20:24, Rasmus Schultz wrote: > Check here to see what we did for php-annotations: > > https://github.com/php-annotations/php-annotations/blob/master/docs/CustomAnnotations.rst#usageannotation > > It's somewhat similar to how C# does it, and it has worked quite nicely. After some fun caused by the way projects keep getting rewritten to comply with the latest undemocratic changes to coding style, I have a copy of php-annotations working without composer and what is imediatly obvious is that current PHPDoc standard could do with an update. php-annotations has some nice extensions such as range and length, but these have been culled from the current builds because they are not part of the standard. The problem is of cause that phpdoc.org are now defining that standard and applying their view of how code should be written, and the tags no longer align with much of the legacy code, which is why we still have the phpDocumentor1 versions being used. docBloc annotation IS well established, but can we at least document a core PHP view of what should be available, and how to extend that to support the alternat tags people are looking for. -- 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