Re: proposal: documenting trunk

On May 25, 2010, at 4:44 AM, Ford, Mike wrote: >> -----Original Message----- >> From: Philip Olson [mailto:philip@roshambo.org] >> Sent: 19 May 2010 05:44 >> To: PHP Documentation ML > > >> Two new entities being proposed: >> - version.trunk.after.53 >> "This is in Subversion trunk only, and will probably exist as of >> PHP 5.4 or 6.0." > > Brilliant idea, but for end users who might not know what the heck Subversion is[*], nor why it > should have a trunk (is there an elephant in the room?!), I would suggest something more like: > > "This is in the current development version of PHP only, and will probably...." > > > [*] and yes it's not all *that* long ago that I was just such a puzzled user trying to > figure out what this CVS thing was that bug reports kept referring to!!! Agreed, and the text was changed before commit which ended up being: "This change exists in the development version of PHP, and will probably exist after 5.3." The commit: - http://svn.php.net/viewvc?view=revision&revision=299627 Initial implementation: - http://svn.php.net/viewvc?view=revision&revision=299628 It links to the about.phpversions section, which was also updated: - http://svn.php.net/viewvc?view=revision&revision=299665 I hope it all makes sense, please review it. Regards, Philip