Doc #55775 [Asn->Csd]: fileperms() return value not documented on success

Edit report at https://bugs.php.net/bug.php?id=55775&edit=1 ID: 55775 Updated by: aharvey@php.net Reported by: chealer at gmail dot com Summary: fileperms() return value not documented on success -Status: Assigned +Status: Closed Type: Documentation Problem Package: Documentation problem PHP Version: Irrelevant Assigned To: aharvey Block user comment: N Private report: 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. Good catch. Thanks! Previous Comments: ------------------------------------------------------------------------ [2012-01-30 14:19:02] aharvey@php.net Automatic comment from SVN on behalf of aharvey Revision: http://svn.php.net/viewvc/?view=revision&revision=322937 Log: Re-fix doc bug #55775 (fileperms() return value not documented on success). ------------------------------------------------------------------------ [2011-09-24 22:08:10] chealer at gmail dot com Thanks for the quick reaction Adam. Unfortunately r317254 introduces a regression. The return value of fileperms() is not what one may expect. It is merely *related* to the UNIX mode. For example, on a directory with mode 02775, fileperms() returned 042775. Without having read the source, my guess is that fileperms() returns an integer representing a string of the UNIX octal mode prepended with a digit representing the file type (4 in this case). Also, although re-using the chmod documentation would seem natural, the chmod documentation is poor. It also assumes the reader is on UNIX. ------------------------------------------------------------------------ [2011-09-24 19:48:59] aharvey@php.net 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. ------------------------------------------------------------------------ [2011-09-24 19:48:55] aharvey@php.net Automatic comment from SVN on behalf of aharvey Revision: http://svn.php.net/viewvc/?view=revision&revision=317254 Log: Fix doc bug #55775 (fileperms() return value not documented on success) by linking to the chmod() page. ------------------------------------------------------------------------ [2011-09-24 19:18:40] chealer at gmail dot com 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 this bug report at https://bugs.php.net/bug.php?id=55775&edit=1