Doc #51684 [Ana]: Manual pages requirement mistype

Edit report at http://bugs.php.net/bug.php?id=51684&edit=1 ID: 51684 User updated by: jmagalhaes dot pt at gmail dot com Reported by: jmagalhaes dot pt at gmail dot com Summary: Manual pages requirement mistype Status: Analyzed Type: Documentation Problem Package: Website problem PHP Version: Irrelevant Assigned To: salathe New Comment: I understand it now. Since I have to deal with several servers with different versions of PHP, sometimes I have make different actions/scripts depending on the server version. With that, I started paying attention to the functions version requirement in the online manual. This was the first time I saw a <= on a function requirement, and wasn't aware that are newer classes being added as root of existing classes (now that you explained it to me, I found PHP 5.1.2 change log: "Added class SplFileInfo as root class for DirectoryIterator and SplFileObject"). My suggestion would be of using some kind of info box (like the notes and tips, don't thing that a warning one is necessary), informing that prior to version x this class/function is an extend of another, or to use the new one instead, or something like that. Thanks. Previous Comments: ------------------------------------------------------------------------ [2010-04-28 21:36:24] salathe@php.net The particular version that you cited is correct; let me explain. The method was introduced with PHP 5.0.0 and the parent SplFileInfo class was introduced in PHP 5.1.2. As of SplFileInfo being around, the DirectoryIterator::isFile method no longer exists as its own entity and is simply inherited from SplFileInfo::isFile. As for the best way to document this without causing further confusion, I'm working on it and open to suggestions. ------------------------------------------------------------------------ [2010-04-28 19:21:15] jmagalhaes dot pt at gmail dot com I was about to reply to your comment, but I'm glad you understand it now. :) I know this isn't any bug, just a mistype, no worries. ------------------------------------------------------------------------ [2010-04-28 19:18:33] philip@php.net Fail, I'll evaluate this :) ------------------------------------------------------------------------ [2010-04-28 19:08:24] philip@php.net Methods get added at random times. In this case, isfile() was added in PHP 5.1.1. PHP <= 5.1.1 === PHP versions greater than or equal to 5.1.1 See Also: http://php.net/manual/en/about.prototypes.php ------------------------------------------------------------------------ [2010-04-28 18:45:12] jmagalhaes dot pt at gmail dot com I was referring to the requirement of the PHP version for the class function is shown as <= 5.1.1. I understood it as if the newer versions (> 5.1.1) wouldn't support that class function. Either I read it wrong or should say only PHP 5 or > 5.1.1. ------------------------------------------------------------------------ The remainder of the comments for this report are too long. To view the rest of the comments, please view the bug report online at http://bugs.php.net/bug.php?id=51684 -- Edit this bug report at http://bugs.php.net/bug.php?id=51684&edit=1