[Emacs-diffs] /srv/bzr/emacs/trunk r111415: * src/fileio.c (Ffile_acl): Undocument return format.

[Stefan Monnier]

------------------------------------------------------------
revno: 111415
committer: Stefan Monnier <address@hidden>
branch nick: trunk
timestamp: Thu 2013-01-03 21:42:08 -0500
message:
  * src/fileio.c (Ffile_acl): Undocument return format.
  * doc/lispref/files.texi (File Attributes): Idem.
modified:
  doc/lispref/ChangeLog
  doc/lispref/files.texi
  src/ChangeLog
  src/fileio.c

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2013-01-03 02:37:57 +0000
+++ b/doc/lispref/ChangeLog     2013-01-04 02:42:08 +0000
@@ -1,3 +1,7 @@
+2013-01-04  Stefan Monnier  <address@hidden>
+
+       * files.texi (File Attributes): Undocument return format of file-acl.
+
 2013-01-03  Glenn Morris  <address@hidden>
 
        * processes.texi (System Processes):

=== modified file 'doc/lispref/files.texi'
--- a/doc/lispref/files.texi    2013-01-02 16:13:04 +0000
+++ b/doc/lispref/files.texi    2013-01-04 02:42:08 +0000
@@ -1363,7 +1363,7 @@
 
 @defun file-acl filename
 This function returns the ACL entries of the file @var{filename}.  The
-return value is a platform-dependent string containing the textual
+return value is a platform-dependent object containing some
 representation of the ACL entries.  Don't use it for anything except
 passing it to the @code{set-file-acl} function (@pxref{Changing Files,
 set-file-acl}).

=== modified file 'src/ChangeLog'
--- a/src/ChangeLog     2013-01-02 19:02:05 +0000
+++ b/src/ChangeLog     2013-01-04 02:42:08 +0000
@@ -1,3 +1,7 @@
+2013-01-04  Stefan Monnier  <address@hidden>
+
+       * fileio.c (Ffile_acl): Undocument return format.
+
 2013-01-02  Glenn Morris  <address@hidden>
 
        * keymap.c (Fkey_description): Doc fix.  (Bug#13323)

=== modified file 'src/fileio.c'
--- a/src/fileio.c      2013-01-02 16:13:04 +0000
+++ b/src/fileio.c      2013-01-04 02:42:08 +0000
@@ -3084,11 +3084,11 @@
 }
 
 DEFUN ("file-acl", Ffile_acl, Sfile_acl, 1, 1, 0,
-       doc: /* Return ACL entries of file named FILENAME, as a string.
+       doc: /* Return ACL entries of file named FILENAME.
+The entries are returned in a format suitable for use in `set-file-acl'
+but is otherwise undocumented and subject to change.
 Return nil if file does not exist or is not accessible, or if Emacs
-was unable to determine the ACL entries.  The latter can happen for
-local files if Emacs was not compiled with ACL support, or for remote
-files if the file handler returns nil for the file's ACL entries.  */)
+was unable to determine the ACL entries.  */)
   (Lisp_Object filename)
 {
   Lisp_Object absname;