[Emacs-diffs] /srv/bzr/emacs/trunk r100976: * tramp.texi (External packages): File attributes cache flushing

[Michael Albinus]

------------------------------------------------------------
revno: 100976
committer: Michael Albinus <address@hidden>
branch nick: trunk
timestamp: Thu 2010-08-05 15:51:21 +0200
message:
  * tramp.texi (External packages): File attributes cache flushing
  for asynchronous processes.
modified:
  doc/misc/ChangeLog
  doc/misc/tramp.texi

=== modified file 'doc/misc/ChangeLog'
--- a/doc/misc/ChangeLog        2010-08-01 18:07:10 +0000
+++ b/doc/misc/ChangeLog        2010-08-05 13:51:21 +0000
@@ -1,3 +1,8 @@
+2010-08-05  Michael Albinus  <address@hidden>
+
+       * tramp.texi (External packages): File attributes cache flushing
+       for asynchronous processes.
+
 2010-08-01  Alan Mackenzie  <address@hidden>
 
        Enhance the manual for the latest Java Mode.

=== modified file 'doc/misc/tramp.texi'
--- a/doc/misc/tramp.texi       2010-07-28 10:25:38 +0000
+++ b/doc/misc/tramp.texi       2010-08-05 13:51:21 +0000
@@ -3471,7 +3471,7 @@
 
 This is a performance degradation, because the lost file attributes
 must be recomputed, when needed again.  In cases the caller of
address@hidden knows that there are file attribute changes, it
address@hidden knows that there are no file attribute changes, it
 shall let-bind the variable @code{process-file-side-effects} to
 @code{nil}.  @value{tramp} wouldn't flush the file attributes cache then.
 
@@ -3479,6 +3479,25 @@
 (let (process-file-side-effects)
   ...)
 @end lisp
+
+For asynchronous processes, @value{tramp} flushes the file attributes
+cache via a process sentinel.  If the caller of
address@hidden knows that there are no file attribute
+changes, it shall set the process sentinel to @code{nil}.  In case the
+caller defines an own process sentinel, @value{tramp}'s process
+sentinel is overwritten.  The caller can still flush the file
+attributes cache in its process sentinel with this code:
+
address@hidden
+(unless (memq (process-status proc) '(run open))
+  (dired-uncache remote-directory))
address@hidden lisp
+
address@hidden shall be the root directory, where file
+attribute changes can happen during the process lifetime.
address@hidden traverses all subdirectories, starting at this
+directory.  Often, it is sufficient to use @code{default-directory} of
+the process buffer as root directory.
 @end ifset