Re: Proposal of removing PHP4 references from the manual

On 14 July 2014 17:01, Hannes Magnusson <hannes.magnusson@gmail.com> wrote: > On Sat, Jul 12, 2014 at 11:44 PM, Maciej Sobaczewski <sobak@php.net> > wrote: > > > *Dealing with removal* > > - determine base version described in the manual - probably just 5.0.0 to > > omit additional confusion > > - remove all entries from changelogs for versions lower than PHP 5.0.0 > > - remove functions not available in PHP5 > > - remove extensions for PHP < 5.0.0 (if we have such) > > - remove all inline references, notes etc. > > > > I thought we did this already? (with the exception of removing PHP4 > from versions.xml - which I don't really see a benefit - its imo is a > fun history "fyi"?) > I believe the intention is to remove all mention of PHP 4 from the manual proper, to an appendix or other standalone document. A quick survey of twitter showed that lots of folks would like this approach (I didn’t see any opposition to the idea, but twitter is a big, scary place and I’m sure someone, somewhere would). > > ext/domxml is no longer available. neither is ext/overload. > php.net/oop4 was moved to the Appendices... > What else is PHP4 specific? > Outside of versions.xml files, we have ~661 (grep | wc -l) mentions of “PHP 4” which are mostly changelogs and “xyz has been bundled since PHP 4.x.y". That said, we do still have things like XSLT lying around. > We've also tried to remove any inline version info, not just php4 > It looks like there’s still some (much smaller than it was previously) way to go. > oldies, as it reads wrong anyway - we've even extended docbook to make > it possible to keep the version info at the top available outside of > refentries. > > Without a concrete action any decision here is useless - like you are > referencing... stuff was decided almost a decade ago and still not > implemented... > I’d like to see this thread arrive at a clear action too, whatever that might be. > > If you find anything that is burried in deep dark places.. Feel free > to fix it :) > > People complaining about keeping a "PHP4 historic version" are roughly > 5years late to the game. > We could resurrect overload and domxml and export into .html page like > php3.php? Is that what they are asking for? > I’d say so, yes. > > -Hannes > P.S. I’m still a little bit on the fence here, pending clarification of what we actually want to do and/or achieve. Personally, I like seeing a function version info like “(PHP 4, PHP 5)” – emphasising our BC friendliness – and a full history in the changelogs. I’d rather not give the impression that 70% (random number pulled from the air) of our functions were brand new to PHP 5.0.0. Then again, who cares if they were in PHP 4?… Cheers, Peter