Doc #51895 [Asn->Csd]: SPL RecursiveDirectoryIteratory Flags documentation

From: Date: Wed, 18 Aug 2010 11:47:33 +0000
Subject: Doc #51895 [Asn->Csd]: SPL RecursiveDirectoryIteratory Flags documentation
References: 1  Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-4881@lists.php.net to get a copy of this message
Edit report at http://bugs.php.net/bug.php?id=51895&edit=1 ID: 51895 Updated by: salathe@php.net Reported by: therandshow at gmail dot com Summary: SPL RecursiveDirectoryIteratory Flags documentation -Status: Assigned +Status: Closed Type: Documentation Problem Package: Documentation problem Operating System: Fedora Linux PHP Version: 5.3.2 Assigned To: salathe Block user comment: N New Comment: This bug has been fixed in the documentation's XML sources. Since the online and downloadable versions of the documentation need some time to get updated, we would like to ask you to be a bit patient. Thank you for the report, and for helping us make our documentation better. I updated the extends/implements list and added a changelog noting the introduction of the FilesystemIterator. Previous Comments: ------------------------------------------------------------------------ [2010-08-18 13:43:17] salathe@php.net Automatic comment from SVN on behalf of salathe Revision: http://svn.php.net/viewvc/?view=revision&revision=302434 Log: recursivedirectoryiterator extends filesystemiterator (doc bug #51895) ------------------------------------------------------------------------ [2010-05-25 07:40:14] dtajchreber@php.net Please ignore the previous comment. Accidental. Sorry. ------------------------------------------------------------------------ [2010-05-25 07:39:32] dtajchreber@php.net Not enough information was provided for us to be able to handle this bug. Please re-read the instructions at http://bugs.php.net/how-to-report.php If you can provide more information, feel free to add it to this bug and change the status back to "Open". Thank you for your interest in PHP. ------------------------------------------------------------------------ [2010-05-24 22:37:26] therandshow at gmail dot com Thanks for pointing out the FilesystemIterator constants, but then one clear issue then is the RecursiveDirectoryIterator's documentation does not say that it extends FilesystemIterator. The class documentation says: " RecursiveDirectoryIterator extends DirectoryIterator implements Traversable , Iterator , RecursiveIterator" None of which extend FilesystemIterator. (Though as you pointed out, even as this was the case, the documentation would be incomplete, as it ought then include an "inherited from FilesytemIterator" section ------------------------------------------------------------------------ [2010-05-24 01:26:15] salathe@php.net The RecursiveDirectoryIterator extends from FilesystemIterator and all of those constants are inherited from it. The docs for the FilesystemIterator constants [1] should give insight into what they are to be used for (they are brief but better than nothing). I'll leave this bug open as a reminder to update the RecursiveDirectoryIterator skeleton documentation with something more substantial. [1] http://php.net/class.filesystemiterator#filesystemiterator.constants ------------------------------------------------------------------------ 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=51895 -- Edit this bug report at http://bugs.php.net/bug.php?id=51895&edit=1

« previous php.doc.bugs (#4881) next »