[Emacs-diffs] emacs/doc/lispref ChangeLog backups.texi buffer...

[Richard M. Stallman]

CVSROOT:        /cvsroot/emacs
Module name:    emacs
Changes by:     Richard M. Stallman <rms>       09/07/16 19:37:08

Modified files:
        doc/lispref    : ChangeLog backups.texi buffers.texi 

Log message:
        * buffers.texi (Swapping Text): Recommend setting
        write-region-annotate-functions and buffer-saved-size.
        
        * backups.texi (Auto-Saving): Document buffer-saved-size = -2.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/lispref/ChangeLog?cvsroot=emacs&r1=1.309&r2=1.310
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/lispref/backups.texi?cvsroot=emacs&r1=1.5&r2=1.6
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/lispref/buffers.texi?cvsroot=emacs&r1=1.14&r2=1.15

Patches:
Index: ChangeLog
===================================================================
RCS file: /cvsroot/emacs/emacs/doc/lispref/ChangeLog,v
retrieving revision 1.309
retrieving revision 1.310
diff -u -b -r1.309 -r1.310
--- ChangeLog   15 Jul 2009 03:09:52 -0000      1.309
+++ ChangeLog   16 Jul 2009 19:37:08 -0000      1.310
@@ -1,3 +1,10 @@
+2009-07-16  Richard Stallman  <address@hidden>
+
+       * 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  <address@hidden>
 
        * edebug.texi: Minor re-phrasings throughout.

Index: backups.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/doc/lispref/backups.texi,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -b -r1.5 -r1.6
--- backups.texi        21 May 2009 15:31:32 -0000      1.5
+++ backups.texi        16 Jul 2009 19:37:08 -0000      1.6
@@ -632,6 +632,10 @@
 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

Index: buffers.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/doc/lispref/buffers.texi,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -b -r1.14 -r1.15
--- buffers.texi        21 May 2009 15:31:32 -0000      1.14
+++ buffers.texi        16 Jul 2009 19:37:08 -0000      1.15
@@ -1192,6 +1192,13 @@
 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
address@hidden 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