Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:87134 Return-Path: Mailing-List: contact internals-help@lists.php.net; run by ezmlm Delivered-To: mailing list internals@lists.php.net Received: (qmail 977 invoked from network); 13 Jul 2015 10:36:08 -0000 Received: from unknown (HELO lists.php.net) (127.0.0.1) by localhost with SMTP; 13 Jul 2015 10:36:08 -0000 Authentication-Results: pb1.pair.com header.from=lester@lsces.co.uk; sender-id=unknown Authentication-Results: pb1.pair.com smtp.mail=lester@lsces.co.uk; spf=permerror; 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:50641] helo=mail4.serversure.net) by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP id C2/B3-43998-69493A55 for ; Mon, 13 Jul 2015 06:36:07 -0400 Received: (qmail 25560 invoked by uid 89); 13 Jul 2015 10:36:04 -0000 Received: by simscan 1.3.1 ppid: 25543, pid: 25555, t: 0.2193s scanners: attach: 1.3.1 clamav: 0.96/m:52/d:10677 Received: from unknown (HELO ?10.0.0.8?) (lester@rainbowdigitalmedia.org.uk@81.138.11.136) by mail4.serversure.net with ESMTPA; 13 Jul 2015 10:36:03 -0000 Message-ID: <55A39493.6020909@lsces.co.uk> Date: Mon, 13 Jul 2015 11:36:03 +0100 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:31.0) Gecko/20100101 Thunderbird/31.7.0 MIME-Version: 1.0 To: internals@lists.php.net References: <55A16375.4000707@php.net> <55A220D8.3090004@gmail.com> <55A363A0.5060307@gmail.com> In-Reply-To: Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit Subject: Re: [PHP-DEV] PHP7 and types - and alternatives to annotation From: lester@lsces.co.uk (Lester Caine) On 13/07/15 08:49, Pierre Joye wrote: >> No, not "just" my IDE can work. IDE is just the side effect. Proper >> > documentation does much more than that. > It seems to go off topic. Docblocks are only slightly related to this > thread. The same could be said about annotation (which are widely used too). Coming from a background of 'traditional' php design, all of my code and the libraries I use are documented via phpdoc style annotation which the IDE picks up, and phpdocumentor1 produced a good API description. This was also a GOOD basis to tidy up the various changes through PHP5.x Today much of the infrastructure to make that work is broken and http://lsces.org.uk/wiki/bitweaver+documentation is a starting point at getting the material all up to date. The original documentation had a few errors on the log file, but http://lsces.org.uk/bwdocs2/index.html is the version I've been working on and is listing 3300 errors in the documentation! The next step is to work out how to address those errors, but once again that is unproductive work so perhaps fixing the problems with the older V1 documenter may be a better use of time? The rules phpdocumenter2 follow seem far adrift from the original 'standard'. So it WOULD be nice if there was an approved standard rather than these seeming to be subject to different interpretation all the time. This before addressing the problems of PHP7 migration ... -- 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