On Wed, Sep 4, 2013 at 5:15 PM, Hannes Magnusson <hannes.magnus...@gmail.com> wrote: > On Wed, Sep 4, 2013 at 3:56 AM, Chris Wright <chr...@aquacool.ltd.uk> wrote: > > > Didn't we archive the PHP4 explicit functionality like we did for PHP3 > > > (http://php.net/manual/php3.php) somewhere?
> > > Stuff like the old DOM extension and overload() function and whatever.. > > Not as far as I can tell. The PHP4 OOP docs where moved to their own > > appendix > > (http://www.php.net/manual/en/oop4.php) but no other elements of > > PHP4-specific > > docs appear to have been given the same treatment. I'm all for doing this at > > the earliest opportunity. > +1 Great. Looking at the way the PHP/FI and PHP3 docs were handled, they were converted to (or always were?) static HTML and aren't maintained in docbook, is this what we would want to do with the PHP4 docs as well or should we keep them as an appendix in the main docs? It doesn't seem like there's much point in keeping then in a readily modifiable state and rebuilding them every time, since they won't ever change. Depressingly there are still PHP4 installations out there in the wild, and while it's unlikely that anyone will need to do a migration these days, there are cases where developers may need to access the docs for userland PHP4 (the OOP model in particular). I do think it would be worth hanging on to as much of the content as reasonably possible, it appears quite a bit of PHP3 documentation was dropped when it was archived (or maybe not, I don't know, it was before my time). > > The docs for overload() appear to have disappeared up their own branch of > > the > > space-time continuum, I was looking for them a few months back when I had > > the > > displeasure of modifying some legacy PHP4 code. If someone could dig them > > out > > I would actually personally appreciate it. > http://www.php.net/manual/fa/book.overload.php > Outdated translations ftw! Fantastic, thanks! > > While we're on the subject of PHP4, do we really need both of the below? > > http://www.php.net/manual/en/faq.migration5.php > > http://www.php.net/manual/en/migration5.php > > I'd be tempted to say that they are no longer necessary in the main manual > > at > > all, but at the very least surely the two can be distilled to a single > > section? > Not even worth merging. Just kill the faq, and archive the migration part? I'm fine with that, no point in putting a load of work into something very few people will ever read.
