* processes.texi (Synchronous Processes): New defvar process-file-side-effects.

2 files changed, 18 insertions, 0 deletions

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 5989793d2c6..081990300b9 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,8 @@
+2009-08-25  Michael Albinus  <michael.albinus@gmx.de>
+
+	* processes.texi (Synchronous Processes): New defvar
+	process-file-side-effects.
+
 2009-08-25  Glenn Morris  <rgm@gnu.org>
 
 	* display.texi (Fontsets): Fix typo.
diff --git a/doc/lispref/processes.texi b/doc/lispref/processes.texi
index 268cec388d0..b198abb91f4 100644
--- a/doc/lispref/processes.texi
+++ b/doc/lispref/processes.texi
@@ -404,6 +404,19 @@ names as relative to @code{default-directory}.  The function
 file names.
 @end defun
 
+@defvar process-file-side-effects
+This variable indicates, whether a call of @code{process-file} changes
+remote files.
+
+Per default, this variable is always set to @code{t}, meaning that a
+call of @code{process-file} could potentially change any file on a
+remote host.  When set to @code{nil}, a file handler could optimize
+its behaviour with respect to remote file attributes caching.
+
+This variable should never be changed by @code{setq}.  Instead of, it
+shall be set only by let-binding.
+@end defvar
+
 @defun call-process-region start end program &optional delete destination display &rest args
 This function sends the text from @var{start} to @var{end} as
 standard input to a process running @var{program}.  It deletes the text