diff options
| author | Eli Zaretskii <eliz@gnu.org> | 2008-05-10 08:54:03 +0000 |
|---|---|---|
| committer | Eli Zaretskii <eliz@gnu.org> | 2008-05-10 08:54:03 +0000 |
| commit | 6af511e3228b185df40e303ce0463d2e4d30293a (patch) | |
| tree | 582a0f5a91eac4fc93b895439080bcafab48d286 /doc | |
| parent | 6c5665e9c472bcca38284bef6142a60e19d96447 (diff) | |
| download | emacs-6af511e3228b185df40e303ce0463d2e4d30293a.tar.gz | |
(Windows Files): Update documentation of w32-get-true-file-attributes.
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/emacs/ChangeLog | 7 | ||||
| -rw-r--r-- | doc/emacs/msdog.texi | 22 |
2 files changed, 23 insertions, 6 deletions
diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog index 9a4a4dece59..e66e7f2c5bc 100644 --- a/doc/emacs/ChangeLog +++ b/doc/emacs/ChangeLog @@ -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> diff --git a/doc/emacs/msdog.texi b/doc/emacs/msdog.texi index 7fe3c9ca07d..80f31689c63 100644 --- a/doc/emacs/msdog.texi +++ b/doc/emacs/msdog.texi @@ -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 |