Re: What to do with documentation of abandoned PECL extensions

On Wed, 5 Jun 2019 at 18:19, Christoph M. Becker <cmbecker69@gmx.de> wrote: > On 05.06.2019 at 16:35, G. P. B. wrote: > > > I'm just curious to know how is the documentation for abandoned > extensions > > handled? > > Is there a process to be able to remove them? > > > > Some of the examples I'm thinking of are: > > > > > > - APC (abandoned in favor of APCu) > > - bcompiler (does not work on PHP 7) > > - DB++ (only PECL release is from 2003 and from the PHP 4 era from my > > understanding) > > - filePro (unmaintained and moved out of PHP in PHP 5.2) > > - FrontBase (can't seem to find it on PECL even though it should have > > been moved to PECL in PHP 5.3, and weirdly all the functions say that > they > > are available in PHP and 7 when IIRC there is a user note saying it > doesn't > > compile as of a version of PHP 5.x) > This one is hosted on svn.php.net[1], and a commit even claims compat > with PHP 7.3, but indeed there's no entry on PECL, and apparently no > releases at all[2]. > Huh, interesting that's kind of odd. > - Informix (no release on PECL and out of PHP in PHP 5.2) > > - MaxDB (last PECL release 2007) > > - Possibly Mhash as it was integrated into Hash? > > > > And there are probably plenty more. > > I also know that the current doc is meant to document the whole life > cycle > > of PHP 5. > > However, I'm also wary of having docs of extensions which are obsolete > and > > don't compile in the doc. > > Or would those get cleaned up when we drop PHP 5 support in the doc > > (possible with the release of PHP 8)? > > In my opinion, we should start to remove pre PHP 5.3 or even PHP 5.4 > specific documentation out of the manual right now (like we did with the > PHP 4 documentation). I think otherwise we're doing most of our readers > and ourselves a disfavor. > I do agree with this as PHP 5.3 has been released nearly 10 years ago now. Would that include changelogs entries or not? I'm going through the whole doc (well more or less) to remove mentions of PHP 4 and 5.0.0 again, that's why I wanted to raise this issue. And also finding loads of instances where there are/weren't any version information (btw thanks for fixing those Christoph). But as I'm pretty new here I don't want to go and just start deleting stuff from the SVN repo without the approval from some of the more senior people here and Peter. > Thanks, > Christoph > > [1] <http://svn.php.net/viewvc/pecl/fbsql/> > [2] <https://bugs.php.net/76200> > Best regards George P. Banyard