summaryrefslogtreecommitdiff
path: root/src/dired.c
diff options
context:
space:
mode:
authorMichael Albinus <michael.albinus@gmx.de>2022-10-13 21:13:45 +0200
committerMichael Albinus <michael.albinus@gmx.de>2022-10-13 21:13:45 +0200
commitcbd04ad3d572850775f18bde868c71abcde733ed (patch)
treecca60866632ff253cbc5062ab7483379e81a1376 /src/dired.c
parent10f55975d34dd7299f72fdf8d93fd8cbe2e41e25 (diff)
Clarify structure of file-attribute's device number
* doc/lispref/buffers.texi (Buffer File Name): Fix description of buffer-file-number. * doc/lispref/files.texi (File Attributes): Clarify type of device number. Describe file-attribute-file-number. (Bug#58446) * etc/NEWS: Mention file-attribute-file-number. * lisp/files.el (buffer-file-number, file-attribute-device-number) (file-attribute-collect): Fix docstring. (file-attribute-file-number): New defsubst. (find-buffer-visiting, find-file-noselect) (set-visited-file-name, basic-save-buffer): * lisp/startup.el (normal-top-level-add-subdirs-to-load-path): * lisp/eshell/em-unix.el (eshell-shuffle-files): Use it. * src/dired.c (Ffile_attributes): Fix docstring.
Diffstat (limited to 'src/dired.c')
-rw-r--r--src/dired.c5
1 files changed, 3 insertions, 2 deletions
diff --git a/src/dired.c b/src/dired.c
index c2c099f0a5f..32c083ad7b0 100644
--- a/src/dired.c
+++ b/src/dired.c
@@ -923,11 +923,12 @@ Elements of the attribute list are:
8. File modes, as a string of ten letters or dashes as in ls -l.
9. An unspecified value, present only for backward compatibility.
10. inode number, as a nonnegative integer.
-11. Filesystem device number, as an integer.
+11. Filesystem device number, as an integer or a cons cell of integers.
Large integers are bignums, so `eq' might not work on them.
On most filesystems, the combination of the inode and the device
-number uniquely identifies the file.
+number uniquely identifies the file. This is provided by the access
+function `file-attribute-file-number'.
On MS-Windows, performance depends on `w32-get-true-file-attributes',
which see.