(Windows Files): Update documentation of w32-get-true-file-attributes.
authorEli Zaretskii <eliz@gnu.org>
Sat, 10 May 2008 08:54:03 +0000 (08:54 +0000)
committerEli Zaretskii <eliz@gnu.org>
Sat, 10 May 2008 08:54:03 +0000 (08:54 +0000)
doc/emacs/ChangeLog
doc/emacs/msdog.texi

index 9a4a4dece593100db61d034e4431718850f28046..e66e7f2c5bcc787ffca491b3729259411a093a59 100644 (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>
 
index 7fe3c9ca07d490ddd76d2cec17f9e93fbf2dcc0a..80f31689c6343e5bfc4bb89cdcf5374ebe60567a 100644 (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