* buffers.texi (Swapping Text): Recommend setting

write-region-annotate-functions and buffer-saved-size.

* backups.texi (Auto-Saving): Document buffer-saved-size = -2.

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index f0e57f6d529ce842205e102a2260e88d076ab931..7f6bca513009e8e555f18d92baffa070a8e3f047 100644 (file)
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,10 @@
+2009-07-16  Richard Stallman  <rms@gnu.org>
+
+       * buffers.texi (Swapping Text): Recommend setting
+       write-region-annotate-functions and buffer-saved-size.
+
+       * backups.texi (Auto-Saving): Document buffer-saved-size = -2.
+
 2009-07-15  Glenn Morris  <rgm@gnu.org>
 
        * edebug.texi: Minor re-phrasings throughout.

diff --git a/doc/lispref/backups.texi b/doc/lispref/backups.texi
index 6de8594607fc9c07baf9c1463a8fb8bba392e40a..d43bce28d7a5ac6e6a7280199be13d2ea3c2d0ba 100644 (file)
--- a/doc/lispref/backups.texi
+++ b/doc/lispref/backups.texi
@@ -632,6 +632,10 @@ this buffer due to a substantial decrease in size.  Explicitly saving
 the buffer stores a positive value in this variable, thus reenabling
 auto-saving.  Turning auto-save mode off or on also updates this
 variable, so that the substantial decrease in size is forgotten.
+
+If it is @minus{}2, that means this buffer should disregard changes in
+buffer size; in particular, it should not shut off auto-saving
+temporarily due to changes in buffer size.
 @end defvar
 
 @defvar auto-save-list-file-name

diff --git a/doc/lispref/buffers.texi b/doc/lispref/buffers.texi
index 5d03865e8e2af1c5f622ae427c4081fff0f050f5..97242d8d5de2d06171ec07a07f303d091001ccd3 100644 (file)
--- a/doc/lispref/buffers.texi
+++ b/doc/lispref/buffers.texi
@@ -1192,6 +1192,13 @@ overlays, the text properties, the undo list, the value of the
 enable-multibyte-characters}), etc.
 @end defun
 
+  If you use @code{buffer-swap-text} on a file-visiting buffer, you
+should set up a hook to save the buffer's original text rather than
+what it was swapped with.  @code{write-region-annotate-functions}
+works for this purpose.  You should probably set
+@code{buffer-saved-size} to @minus{}2 in the buffer, so that changes
+in the text it is swapped with will not interfere with auto-saving.
+
 @node Buffer Gap
 @section The Buffer Gap