mirrors/emacs
1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-29 00:31:01 -08:00
Code Issues Projects Releases Wiki Activity

Fdirectory_files_and_attributes doc string clarification

Browse source 
* src/dired.c (Fdirectory_files_and_attributes): Clarify what data
is returned.
This commit is contained in:
Lars Ingebrigtsen 2018-05-31 13:51:45 +02:00
parent e50634c354
commit 8ca4228393
1 changed files with 10 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

10
src/dired.c
View file

@ -358,6 +358,16 @@ If NOSORT is non-nil, the list is not sorted--its order is unpredictable.
DEFUN ("directory-files-and-attributes", Fdirectory_files_and_attributes,
Sdirectory_files_and_attributes, 1, 5, 0,
doc: /* Return a list of names of files and their attributes in DIRECTORY.
The list returned has elements that contain the data from
`file-attributes' for each file -- with the file name prepended. So
the structure of each element is
`(FILE-NAME FILE-ATTRIBUTE1 FILE-ATTRIBUTE2 ...)'.
For instance, to get the size of the fourth element in a directory,
you could say:
(file-attribute-size (cdr (nth 3 (directory-files-and-attributes "/"))))
There are four optional arguments:
If FULL is non-nil, return absolute file names. Otherwise return names
that are relative to the specified directory.