From: Eli Zaretskii Date: Mon, 5 Oct 2009 08:35:41 +0000 (+0000) Subject: (Ffile_attributes): Doc fix. (Bug#4638) X-Git-Tag: emacs-pretest-23.1.90~926 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=e02131a2578f41661ff5562923f3b6543a3ce1c6;p=emacs.git (Ffile_attributes): Doc fix. (Bug#4638) --- diff --git a/src/ChangeLog b/src/ChangeLog index 325ae19b160..229974e2076 100644 --- a/src/ChangeLog +++ b/src/ChangeLog @@ -1,3 +1,7 @@ +2009-10-05 Eli Zaretskii + + * dired.c (Ffile_attributes): Doc fix. (Bug#4638) + 2009-10-04 Eli Zaretskii * xdisp.c (syms_of_xdisp) : diff --git a/src/dired.c b/src/dired.c index 2f0d7993a76..10d8782d023 100644 --- a/src/dired.c +++ b/src/dired.c @@ -973,20 +973,26 @@ Elements of the attribute list are: 3. File gid, likewise. 4. Last access time, as a list of two integers. First integer has high-order 16 bits of time, second has low 16 bits. - (See a note below about FAT-based filesystems.) - 5. Last modification time, likewise. - 6. Last status change time, likewise. + (See a note below about access time on FAT-based filesystems.) + 5. Last modification time, likewise. This is the time of the last + change to the file's contents. + 6. Last status change time, likewise. This is the time of last change + to the file's attributes: owner and group, access mode bits, etc. 7. Size in bytes. This is a floating point number if the size is too large for an integer. 8. File modes, as a string of ten letters or dashes as in ls -l. 9. t if file's gid would change if file were deleted and recreated. -10. inode number. If inode number is larger than the Emacs integer, - but still fits into a 32-bit number, this is a cons cell containing two - integers: first the high part, then the low 16 bits. If the inode number - is wider than 32 bits, this is a cons cell containing three integers: - first the high 24 bits, then middle 24 bits, and finally the low 16 bits. -11. Device number. If it is larger than the Emacs integer, this is - a cons cell, similar to the inode number. +10. inode number. If inode number is larger than what Emacs integer + can hold, but still fits into a 32-bit number, this is a cons cell + containing two integers: first the high part, then the low 16 bits. + If the inode number is wider than 32 bits, this is of the form + (HIGH MIDDLE . LOW): first the high 24 bits, then middle 24 bits, + and finally the low 16 bits. +11. Filesystem device number. If it is larger than what the Emacs + integer can hold, this is a cons cell, similar to the inode number. + +On most filesystems, the combination of the inode and the device +number uniquely identifies the file. On MS-Windows, performance depends on `w32-get-true-file-attributes', which see.