Doc #51895 [NEW]: SPL RecursiveDirectoryIteratory Flags documentation

From: Operating system: Fedora Linux PHP version: 5.3.2 Package: Documentation problem Bug Type: Documentation Problem Bug description:SPL RecursiveDirectoryIteratory Flags documentation Description: ------------ While understand that much of the SPL extension is undocumented, it occurs to me that there's a simple piece of documentation that could be added. On this page: http://us.php.net/manual/en/recursivedirectoryiterator.construct.php it refers to "flags" without telling what options there are for flags. Now it is documented here that there are flags defined as recursive iterator class constants http://us.php.net/manual/en/spl.constants.php , but I guessed that was unlikely to be all the flags possible. Thus I used the ReflectionClass to get all of RecursiveDirectoryIterator's class constants and got this array: array(11) { ["CURRENT_MODE_MASK"]=> int(240) ["CURRENT_AS_PATHNAME"]=> int(32) ["CURRENT_AS_FILEINFO"]=> int(0) ["CURRENT_AS_SELF"]=> int(16) ["KEY_MODE_MASK"]=> int(3840) ["KEY_AS_PATHNAME"]=> int(0) ["FOLLOW_SYMLINKS"]=> int(512) ["KEY_AS_FILENAME"]=> int(256) ["NEW_CURRENT_AND_KEY"]=> int(256) ["SKIP_DOTS"]=> int(4096) ["UNIX_PATHS"]=> int(8192) } Test script: --------------- $reflector = new ReflectionClass('RecursiveDirectoryIterator'); var_dump($reflector->getConstants()); Expected result: ---------------- array(11) { ["CURRENT_MODE_MASK"]=> int(240) ["CURRENT_AS_PATHNAME"]=> int(32) ["CURRENT_AS_FILEINFO"]=> int(0) ["CURRENT_AS_SELF"]=> int(16) ["KEY_MODE_MASK"]=> int(3840) ["KEY_AS_PATHNAME"]=> int(0) ["FOLLOW_SYMLINKS"]=> int(512) ["KEY_AS_FILENAME"]=> int(256) ["NEW_CURRENT_AND_KEY"]=> int(256) ["SKIP_DOTS"]=> int(4096) ["UNIX_PATHS"]=> int(8192) } Actual result: -------------- array(11) { ["CURRENT_MODE_MASK"]=> int(240) ["CURRENT_AS_PATHNAME"]=> int(32) ["CURRENT_AS_FILEINFO"]=> int(0) ["CURRENT_AS_SELF"]=> int(16) ["KEY_MODE_MASK"]=> int(3840) ["KEY_AS_PATHNAME"]=> int(0) ["FOLLOW_SYMLINKS"]=> int(512) ["KEY_AS_FILENAME"]=> int(256) ["NEW_CURRENT_AND_KEY"]=> int(256) ["SKIP_DOTS"]=> int(4096) ["UNIX_PATHS"]=> int(8192) } -- Edit bug report at http://bugs.php.net/bug.php?id=51895&edit=1 -- Try a snapshot (PHP 5.2): http://bugs.php.net/fix.php?id=51895&r=trysnapshot52 Try a snapshot (PHP 5.3): http://bugs.php.net/fix.php?id=51895&r=trysnapshot53 Try a snapshot (PHP 6.0): http://bugs.php.net/fix.php?id=51895&r=trysnapshot60 Fixed in SVN: http://bugs.php.net/fix.php?id=51895&r=fixed Fixed in SVN and need be documented: http://bugs.php.net/fix.php?id=51895&r=needdocs Fixed in release: http://bugs.php.net/fix.php?id=51895&r=alreadyfixed Need backtrace: http://bugs.php.net/fix.php?id=51895&r=needtrace Need Reproduce Script: http://bugs.php.net/fix.php?id=51895&r=needscript Try newer version: http://bugs.php.net/fix.php?id=51895&r=oldversion Not developer issue: http://bugs.php.net/fix.php?id=51895&r=support Expected behavior: http://bugs.php.net/fix.php?id=51895&r=notwrong Not enough info: http://bugs.php.net/fix.php?id=51895&r=notenoughinfo Submitted twice: http://bugs.php.net/fix.php?id=51895&r=submittedtwice register_globals: http://bugs.php.net/fix.php?id=51895&r=globals PHP 4 support discontinued: http://bugs.php.net/fix.php?id=51895&r=php4 Daylight Savings: http://bugs.php.net/fix.php?id=51895&r=dst IIS Stability: http://bugs.php.net/fix.php?id=51895&r=isapi Install GNU Sed: http://bugs.php.net/fix.php?id=51895&r=gnused Floating point limitations: http://bugs.php.net/fix.php?id=51895&r=float No Zend Extensions: http://bugs.php.net/fix.php?id=51895&r=nozend MySQL Configuration Error: http://bugs.php.net/fix.php?id=51895&r=mysqlcfg