Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:44393
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: error (pb1.pair.com: domain lsces.co.uk from 213.123.20.124 cause and error)
Message-ID: <4A3E67BB.8040109@lsces.co.uk>
Date: Sun, 21 Jun 2009 18:02:51 +0100
User-Agent: Mozilla/5.0 (X11; U; Linux x86_64; en-GB; rv:1.8.1.21) Gecko/20090408 SeaMonkey/1.1.16
MIME-Version: 1.0
To: PHP internals <internals@lists.php.net>
References: <4A3BBF03.5050207@lerdorf.com> <4A3E0A1B.3080305@googlemail.com> <2308C596-45DC-433C-BB7B-2889E28142DC@darkrainfall.org>
In-Reply-To: <2308C596-45DC-433C-BB7B-2889E28142DC@darkrainfall.org>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Subject: Re: [PHP-DEV] Call for a doc push
From: lester@lsces.co.uk (Lester Caine)

Gwynne Raskind wrote:
> On Jun 21, 2009, at 6:23 AM, zoe wrote:
>>> Guys and gals, in the old days we had a very close tie between the code
>>> and the documentation.  As the project has grown the two have drifted
>>> apart.  I think this is mostly because the phpdoc team has done an
>>> amazing job keeping up with the code changes and writing awesome
>>> documentation.  This has made us a bit lazy and complacent.
>>>
>>> I would like to encourage everyone on this list to spend a little bit of
>>> time looking at the parts of the documentation that cover things you are
>>> familiar with.  Or even just going through some of the doc bugs and
>>> helping out in general.
>>>
>> This reminded me that a while ago I made some opcode documentation 
>> available in the form of a set of charts written by Andy Wharmby 
>> (http://www.zapt.info/PHPOpcodes_Sep2008.odp) and some opcode samples 
>> (http://www.zapt.info/opcodes.html) from the IBM Japan team. I don't 
>> think either of these ever made it the PHP docs and as they are  still 
>> on my personal website and they are somewhat at risk :-/
>> I heard recently that people were using them 
>> (http://tr.im/phpcompilerinternals) so I'd like to put them somewhere 
>> more permanent. My current plan is to move them both to sp1.php.net. 
>> Does anyone object? Or better still would anyone be willing to 
>> integrate them with the PHP docs?
> 
> Zoe, have a look at <http://news.php.net/php.doc.cvs/4180> :). I don't 
> have anything that can read that ODP file you linked (at least, not in 
> any useful sense), but the opcodes.html file is all there. With any 
> luck, someone else will come along and clean it up a bit, and/or expand 
> on it.

http://enquirysolve.co.uk/fisheye/view_image.php?image_id=3790
Is the Opcode paper as a PDF, but it's simply an OpenOffice presentation 
so doesn't need anything 'expensive' to read and edit it.

-- 
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//
Firebird - http://www.firebirdsql.org/index.php