Doc #55775 [NEW]: fileperms() return value not documented on success

From: Operating system: PHP version: Irrelevant Package: Documentation problem Bug Type: Documentation Problem Bug description:fileperms() return value not documented on success Description: ------------ http://ca2.php.net/manual/en/function.fileperms.php fileperms() gets file permissions and returns them. However, the only thing the documentation says about the return value is: Returns the permissions on the file, or FALSE on failure. There is no hint of how file permissions are represented except in examples, which show that the return value contains more than permissions, and that it is returned as an integer related to UNIX file permissions modes. -- Edit bug report at https://bugs.php.net/bug.php?id=55775&edit=1 -- Try a snapshot (PHP 5.4): https://bugs.php.net/fix.php?id=55775&r=trysnapshot54 Try a snapshot (PHP 5.3): https://bugs.php.net/fix.php?id=55775&r=trysnapshot53 Try a snapshot (trunk): https://bugs.php.net/fix.php?id=55775&r=trysnapshottrunk Fixed in SVN: https://bugs.php.net/fix.php?id=55775&r=fixed Fixed in SVN and need be documented: https://bugs.php.net/fix.php?id=55775&r=needdocs Fixed in release: https://bugs.php.net/fix.php?id=55775&r=alreadyfixed Need backtrace: https://bugs.php.net/fix.php?id=55775&r=needtrace Need Reproduce Script: https://bugs.php.net/fix.php?id=55775&r=needscript Try newer version: https://bugs.php.net/fix.php?id=55775&r=oldversion Not developer issue: https://bugs.php.net/fix.php?id=55775&r=support Expected behavior: https://bugs.php.net/fix.php?id=55775&r=notwrong Not enough info: https://bugs.php.net/fix.php?id=55775&r=notenoughinfo Submitted twice: https://bugs.php.net/fix.php?id=55775&r=submittedtwice register_globals: https://bugs.php.net/fix.php?id=55775&r=globals PHP 4 support discontinued: https://bugs.php.net/fix.php?id=55775&r=php4 Daylight Savings: https://bugs.php.net/fix.php?id=55775&r=dst IIS Stability: https://bugs.php.net/fix.php?id=55775&r=isapi Install GNU Sed: https://bugs.php.net/fix.php?id=55775&r=gnused Floating point limitations: https://bugs.php.net/fix.php?id=55775&r=float No Zend Extensions: https://bugs.php.net/fix.php?id=55775&r=nozend MySQL Configuration Error: https://bugs.php.net/fix.php?id=55775&r=mysqlcfg