(Windows Files): Update documentation of w32-get-true-file-attributes.

This commit is contained in:
Eli Zaretskii 2008-05-10 08:54:03 +00:00
parent 6c5665e9c4
commit 6af511e322
2 changed files with 23 additions and 6 deletions

View file

@ -1,3 +1,8 @@
2008-05-10 Eli Zaretskii <eliz@gnu.org>
* msdog.texi (Windows Files): Update documentation of
w32-get-true-file-attributes.
2008-05-09 Eric S. Raymond <esr@snark.thyrsus.com>
* files.texi, vc-xtra.texi, vc1-xtra.texi: Document the new VC
@ -6,7 +11,7 @@
2008-05-08 Chong Yidong <cyd@stupidchicken.com>
* killing.texi (Appending Kills): Remove a strangely off-topic index
entry.
entry "television".
2008-05-07 Eric S. Raymond <esr@snark.thyrsus.com>

View file

@ -172,11 +172,23 @@ backslash, and also knows about drive letters in file names.
default ignores letter-case in file names during completion.
@vindex w32-get-true-file-attributes
If the variable @code{w32-get-true-file-attributes} is
non-@code{nil} (the default), Emacs tries to determine the accurate
link counts for files. This option is only useful on NTFS volumes,
and it considerably slows down Dired and other features, so disable it
on slow machines.
The variable @code{w32-get-true-file-attributes} controls whether
Emacs should issue additional system calls to determine more
accurately file attributes in primitives like @code{file-attributes}
and @code{directory-files-and-attributes}. These additional calls are
needed to report correct file ownership, link counts and file types
for special files such as pipes. Without these system calls, file
ownership will be attributed to the current user, link counts will be
always reported as 1, and special files will be reported as regular
files.
If the value of this variable is @code{local} (the default), Emacs
will issue these additional system calls only for files on local fixed
drives. Any other non-@code{nil} value means do this even for
removable and remote volumes, where this could potentially slow down
Dired and other related features. The value of @code{nil} means never
issue those system calls. Non-@code{nil} values are only useful on
NTFS volumes, which support hard links and file security.
@node ls in Lisp
@section Emulation of @code{ls} on MS-Windows