emacs-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Emacs-diffs] /srv/bzr/emacs/trunk r107225: Doc fixes for remote-file-na


From: Glenn Morris
Subject: [Emacs-diffs] /srv/bzr/emacs/trunk r107225: Doc fixes for remote-file-name-inhibit-cache
Date: Fri, 10 Feb 2012 00:08:23 -0800
User-agent: Bazaar (2.3.1)

------------------------------------------------------------
revno: 107225
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Fri 2012-02-10 00:08:23 -0800
message:
  Doc fixes for remote-file-name-inhibit-cache
  
  * doc/lispref/files.texi (Magic File Names):
  Tweak remote-file-name-inhibit-cache entry.
  * lisp/files.el (remote-file-name-inhibit-cache): Doc fixes.
  * etc/NEWS: Edits.
modified:
  doc/lispref/ChangeLog
  doc/lispref/files.texi
  etc/NEWS
  lisp/ChangeLog
  lisp/files.el
=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2012-02-10 07:57:21 +0000
+++ b/doc/lispref/ChangeLog     2012-02-10 08:08:23 +0000
@@ -9,6 +9,8 @@
 
 2012-02-10  Glenn Morris  <address@hidden>
 
+       * files.texi (Magic File Names): Tweak remote-file-name-inhibit-cache.
+
        * modes.texi (Basic Major Modes): Mention tabulated-list-mode.
 
 2012-02-08  Glenn Morris  <address@hidden>

=== modified file 'doc/lispref/files.texi'
--- a/doc/lispref/files.texi    2012-01-29 03:11:45 +0000
+++ b/doc/lispref/files.texi    2012-02-10 08:08:23 +0000
@@ -2862,24 +2862,21 @@
 @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
+The attributes of remote files can be cached for better performance.  If
+they are changed outside of Emacs's 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.
+When this variable is set to @code{nil}, cached values are never
+expired.  Use this setting with caution, only if you are sure nothing
+other than Emacs ever changes the remote files.  If it is set to
address@hidden, cached values are never used.  This is the safest value, but
+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:
+cached.  If a remote file is checked regularly, it might be a good
+idea to let-bind this variable to a value less than the time period
+between consecutive checks.  For example:
 
 @example
 (defun display-time-file-nonempty-p (file)

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2012-02-10 07:44:39 +0000
+++ b/etc/NEWS  2012-02-10 08:08:23 +0000
@@ -305,9 +305,6 @@
 +++
 *** The new functions file-selinux-context and set-file-selinux-context
 get and set the SELinux context of a file.
----
-*** Tramp offers handlers for file-selinux-context and set-file-selinux-context
-for remote machines which support SELinux.
 
 ** Changes for exiting Emacs
 +++
@@ -385,9 +382,6 @@
 offers to save the theme to `custom-safe-themes' automatically.  By
 default, all themes included in Emacs are treated as safe.
 
-** The user option `remote-file-name-inhibit-cache' controls whether
-the remote file-name cache is used for read access.
-
 ** File- and directory-local variable changes
 +++
 *** You can stop directory local vars from applying to subdirectories.
@@ -855,9 +849,15 @@
 ---
 *** The following access methods are discontinued: "ssh1_old",
 "ssh2_old", "scp1_old", "scp2_old", "imap", "imaps" and "fish".
++++
+*** The user option `remote-file-name-inhibit-cache' controls whether
+remote file attributes are cached for better performance.
 ---
 *** The option `ange-ftp-binary-file-name-regexp' has changed its
 default value to "".
+---
+*** Handlers for file-selinux-context and set-file-selinux-context for
+remote machines that support SELinux.
 
 +++
 ** New function, url-queue-retrieve, fetches URLs asynchronously like
@@ -923,7 +923,7 @@
 ---
 *** pc-mode.el is obsolete (CUA mode is much more comprehensive).
 
-[gnus.texi, message.texi need updating]
+[FIXME gnus.texi, message.texi need updating]
 *** pgg is obsolete (use EasyPG instead)
 
 ---

=== modified file 'lisp/ChangeLog'
--- a/lisp/ChangeLog    2012-02-09 22:42:12 +0000
+++ b/lisp/ChangeLog    2012-02-10 08:08:23 +0000
@@ -1,3 +1,7 @@
+2012-02-10  Glenn Morris  <address@hidden>
+
+       * files.el (remote-file-name-inhibit-cache): Doc fixes.
+
 2012-02-09  Lars Ingebrigtsen  <address@hidden>
 
        * mail/smtpmail.el (smtpmail-user-mail-address): New function.

=== modified file 'lisp/files.el'
--- a/lisp/files.el     2012-02-09 20:27:54 +0000
+++ b/lisp/files.el     2012-02-10 08:08:23 +0000
@@ -981,20 +981,18 @@
 
 (defcustom remote-file-name-inhibit-cache 10
   "Whether to use the remote file-name cache for read access.
-
-When `nil', always use the cached values.
-When `t', never use them.
-A number means use them for that amount of seconds since they were
-cached.
-
-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 invalidated.
-
-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:
+When `nil', never expire cached values (caution)
+When `t', never use the cache (safe, but may be slow)
+A number means use cached values for that amount of seconds since caching.
+
+The attributes of remote files are cached for better performance.
+If they are changed outside of Emacs's control, the cached values
+become invalid, and must be reread.  If you are sure that nothing
+other than Emacs changes the files, you can set this variable to `nil'.
+
+If a remote file is checked regularly, it might be a good idea to
+let-bind this variable to a value less than the interval between
+consecutive checks.  For example:
 
   (defun display-time-file-nonempty-p (file)
     (let ((remote-file-name-inhibit-cache (- display-time-interval 5)))


reply via email to

[Prev in Thread] Current Thread [Next in Thread]