mirrors/emacs
1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2026-02-04 14:40:54 -08:00
Code Issues Projects Releases Wiki Activity

* files.texi (Magic File Names): New defopt remote-file-name-inhibit-cache.

Browse source
This commit is contained in:
Michael Albinus 2010-10-03 17:58:09 +02:00
parent f99d75f5bb
commit 178fdd41ca
2 changed files with 33 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

5
doc/lispref/ChangeLog
View file

@ -1,3 +1,8 @@
2010-10-03 Michael Albinus <michael.albinus@gmx.de>
* files.texi (Magic File Names): New defopt
remote-file-name-inhibit-cache.
2010-10-02 Glenn Morris <rgm@gnu.org>
* os.texi (Killing Emacs): Hook now runs in batch mode.

28
doc/lispref/files.texi
View file

@ -2857,6 +2857,34 @@ non-magic directory to serve as its current directory, and this function
is a good way to come up with one.
@end defun
@defopt remote-file-name-inhibit-cache
Whether to use the remote file-name cache for read access.
File attributes of remote files are cached for better performance. If
they are changed out of Emacs' control, the cached values become
invalid, and must be reread.
When set to @code{nil}, cached values are always used. This shall be
set with care. When set to @code{t}, cached values are never used.
ALthough this is the safest value, it could result in performance
degradation.
A compromise is to set it to a positive number. This means that
cached values are used for that amount of seconds since they were
cached.
In case a remote file is checked regularly, it might be reasonable to
let-bind this variable to a value less then the time period between
two checks. Example:
@example
(defun display-time-file-nonempty-p (file)
(let ((remote-file-name-inhibit-cache (- display-time-interval 5)))
(and (file-exists-p file)
(< 0 (nth 7 (file-attributes (file-chase-links file)))))))
@end example
@end defopt
@node Format Conversion
@section File Format Conversion