Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:87138 Return-Path: Mailing-List: contact internals-help@lists.php.net; run by ezmlm Delivered-To: mailing list internals@lists.php.net Received: (qmail 14093 invoked from network); 13 Jul 2015 12:19:43 -0000 Received: from unknown (HELO lists.php.net) (127.0.0.1) by localhost with SMTP; 13 Jul 2015 12:19:43 -0000 Authentication-Results: pb1.pair.com smtp.mail=vchkpw@developersdesk.com; spf=pass; sender-id=pass Authentication-Results: pb1.pair.com header.from=vchkpw@developersdesk.com; sender-id=pass Received-SPF: pass (pb1.pair.com: domain developersdesk.com designates 204.228.229.4 as permitted sender) X-PHP-List-Original-Sender: vchkpw@developersdesk.com X-Host-Fingerprint: 204.228.229.4 lessa.developersdesk.com Received: from [204.228.229.4] ([204.228.229.4:57523] helo=mail.developersdesk.com) by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP id 49/F5-43998-BDCA3A55 for ; Mon, 13 Jul 2015 08:19:40 -0400 Received: (qmail 20664 invoked by uid 89); 13 Jul 2015 12:19:36 -0000 Received: from unknown (HELO ?192.168.0.150?) (vchkpw@developersdesk.com@96.19.163.170) by 0 with ESMTPA; 13 Jul 2015 12:19:36 -0000 Message-ID: <55A3ACD5.5070808@developersdesk.com> Date: Mon, 13 Jul 2015 06:19:33 -0600 User-Agent: Mozilla/5.0 (Windows NT 6.1; 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> <55A39493.6020909@lsces.co.uk> In-Reply-To: <55A39493.6020909@lsces.co.uk> Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit Subject: Re: [PHP-DEV] PHP7 and types - and alternatives to annotation From: vchkpw@developersdesk.com (Rick Widmer) On 7/13/2015 4:36 AM, Lester Caine wrote: > 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, buthttp://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, Phpdocumentor2? I don't remember the details, but a single patch cleaned up a ton of errors for me. I googled the error message and found a github? pull request or bug report. The best answer is at the bottom of the discussion. As of the last time I loaded it, about 3 months ago, I still had to apply the patch.