[Emacs-diffs] Changes to emacs/lispref/files.texi

[Lars Hansen]

Index: emacs/lispref/files.texi
diff -c emacs/lispref/files.texi:1.57 emacs/lispref/files.texi:1.58
*** emacs/lispref/files.texi:1.57       Sun Nov  2 01:29:57 2003
--- emacs/lispref/files.texi    Fri Nov 21 13:25:20 2003
***************
*** 1048,1056 ****
  @end example
  @end defun
  
! @defun file-attributes filename
  This function returns a list of attributes of file @var{filename}.  If
  the specified file cannot be opened, it returns @code{nil}.
  
  The elements of the list, in order, are:
  
--- 1048,1062 ----
  @end example
  @end defun
  
! @defun file-attributes filename &optional id-format
  This function returns a list of attributes of file @var{filename}.  If
  the specified file cannot be opened, it returns @code{nil}.
+ The optional parameter @var{id-format} specifies the preferred format
+ of attributes @acronym{UID} and @acronym{GID} (see below)---the
+ valid values are @code{'string} and @code{'integer}.  The latter is
+ the default, but we plan to change that, so you should specify a
+ address@hidden value for @var{id-format} if you use the returned
+ @acronym{UID} or @acronym{GID}.
  
  The elements of the list, in order, are:
  
***************
*** 1066,1075 ****
  (@pxref{Changing Files}).
  
  @item
! The file's @acronym{UID}.
  
  @item
! The file's @acronym{GID}.
  
  @item
  The time of last access, as a list of two integers.
--- 1072,1082 ----
  (@pxref{Changing Files}).
  
  @item
! The file's @acronym{UID} as a string or an integer.  If a string
! value cannot be looked up, the integer value is returned.
  
  @item
! The file's @acronym{GID} likewise.
  
  @item
  The time of last access, as a list of two integers.
***************
*** 1114,1121 ****
  
  @example
  @group
! (file-attributes "files.texi")
!      @result{}  (nil 1 2235 75
            (8489 20284)
            (8489 20284)
            (8489 20285)
--- 1121,1128 ----
  
  @example
  @group
! (file-attributes "files.texi" 'string)
!      @result{}  (nil 1 "lh" "users"
            (8489 20284)
            (8489 20284)
            (8489 20285)
***************
*** 1135,1145 ****
  has only one name (the name @file{files.texi} in the current default
  directory).
  
! @item 2235
! is owned by the user with @acronym{UID} 2235.
  
! @item 75
! is in the group with @acronym{GID} 75.
  
  @item (8489 20284)
  was last accessed on Aug 19 00:09.
--- 1142,1152 ----
  has only one name (the name @file{files.texi} in the current default
  directory).
  
! @item "lh"
! is owned by the user with name "lh".
  
! @item "users"
! is in the group with name "users".
  
  @item (8489 20284)
  was last accessed on Aug 19 00:09.