[Emacs-diffs] Changes to emacs/doc/emacs/msdog.texi,v

[Eli Zaretskii]

CVSROOT:        /cvsroot/emacs
Module name:    emacs
Changes by:     Eli Zaretskii <eliz>    08/05/10 08:53:24

Index: msdog.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/doc/emacs/msdog.texi,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -b -r1.5 -r1.6
--- msdog.texi  9 Feb 2008 14:06:18 -0000       1.5
+++ msdog.texi  10 May 2008 08:53:24 -0000      1.6
@@ -172,11 +172,23 @@
 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
address@hidden (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 address@hidden 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.  address@hidden 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