Re: What to do with documentation of abandoned PECL extensions

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]. > - 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. Thanks, Christoph [1] <http://svn.php.net/viewvc/pecl/fbsql/> [2] <https://bugs.php.net/76200>