From cbd04ad3d572850775f18bde868c71abcde733ed Mon Sep 17 00:00:00 2001 From: Michael Albinus Date: Thu, 13 Oct 2022 21:13:45 +0200 Subject: 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. --- src/dired.c | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) (limited to 'src/dired.c') 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. -- cgit v1.2.3