Doc #51895 [Asn->Csd]: SPL RecursiveDirectoryIteratory Flags documentation
| From: | salathe@php.net | 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