[prev in list] [next in list] [prev in thread] [next in thread] 

List:       php-doc-cvs
Subject:    [DOC-CVS] =?utf-8?q?svn:_/phpdoc/en/trunk/reference/filesystem/functions/_fileperms.xml?=
From:       Adam_Harvey <aharvey () php ! net>
Date:       2012-01-30 14:19:05
Message-ID: svn-aharvey-1327933145-322937-399021247 () svn ! php ! net
[Download RAW message or body]

aharvey                                  Mon, 30 Jan 2012 14:19:05 +0000

Revision: http://svn.php.net/viewvc?view=revision&revision=322937

Log:
Re-fix doc bug #55775 (fileperms() return value not documented on success).

Bug: https://bugs.php.net/55775 (Assigned) fileperms() return value not documented on success
      
Changed paths:
    U   phpdoc/en/trunk/reference/filesystem/functions/fileperms.xml

Modified: phpdoc/en/trunk/reference/filesystem/functions/fileperms.xml
===================================================================
--- phpdoc/en/trunk/reference/filesystem/functions/fileperms.xml	2012-01-30 14:09:42 UTC (rev 322936)
+++ phpdoc/en/trunk/reference/filesystem/functions/fileperms.xml	2012-01-30 14:19:05 UTC (rev 322937)
@@ -36,9 +36,21 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Returns the file's permissions as a numeric mode of the same format as that
-   expected by <function>chmod</function>, &return.falseforfailure;.
+   Returns the file's permissions as a numeric mode. Lower bits of this mode
+   are the same as the permissions expected by <function>chmod</function>,
+   however on most platforms the return value will also include information on
+   the type of file given as <parameter>filename</parameter>. The examples
+   below demonstrate how to test the return value for specific permissions and
+   file types on POSIX systems, including Linux and Mac OS X.
   </para>
+  <para>
+   For local files, the specific return value is that of the
+   <literal>st_mode</literal> member of the structure returned by the C
+   library's <function>stat</function> function. Exactly which bits are set
+   can vary from platform to platform, and looking up your specific platform's
+   documentation is recommended if parsing the non-permission bits of the
+   return value is required.
+  </para>
  </refsect1>

  <refsect1 role="examples">



-- 
PHP Documentation Commits Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php

[prev in list] [next in list] [prev in thread] [next in thread]