[Emacs-diffs] /srv/bzr/emacs/trunk r107423: Update Backups chapter of Lisp manual.

[Chong Yidong]

------------------------------------------------------------
revno: 107423
committer: Chong Yidong <address@hidden>
branch nick: trunk
timestamp: Sat 2012-02-25 17:32:33 +0800
message:
  Update Backups chapter of Lisp manual.
  
  * doc/lispref/backups.texi (Making Backups): Mention default value of 
backup-directory-alist.
  (Rename or Copy): Note that backup-by-copying-when-mismatch is t.
  (Auto-Saving): New minor mode behavior for auto-save-mode.
  (Reverting): Add defvar for revert-buffer-in-progress-p.
modified:
  admin/FOR-RELEASE
  doc/lispref/ChangeLog
  doc/lispref/backups.texi
  etc/NEWS

=== modified file 'admin/FOR-RELEASE'
--- a/admin/FOR-RELEASE 2012-02-23 08:32:18 +0000
+++ b/admin/FOR-RELEASE 2012-02-25 09:32:33 +0000
@@ -184,7 +184,7 @@
 advice.texi       cyd
 anti.texi         
 back.texi
-backups.texi      
+backups.texi      cyd
 buffers.texi      
 commands.texi     cyd
 compile.texi      cyd

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2012-02-25 09:07:23 +0000
+++ b/doc/lispref/ChangeLog     2012-02-25 09:32:33 +0000
@@ -5,7 +5,10 @@
        (Changing Files): Document set-file-selinux-context.
 
        * backups.texi (Making Backups): Return value of backup-buffer is
-       changed.
+       changed.  Mention default value of backup-directory-alist.
+       (Rename or Copy): Note that backup-by-copying-when-mismatch is t.
+       (Auto-Saving): New minor mode behavior for auto-save-mode.
+       (Reverting): Add defvar for revert-buffer-in-progress-p.
 
        * searching.texi (Regexp Backslash): Add index entry (Bug#10869).
 

=== modified file 'doc/lispref/backups.texi'
--- a/doc/lispref/backups.texi  2012-02-25 09:07:23 +0000
+++ b/doc/lispref/backups.texi  2012-02-25 09:32:33 +0000
@@ -140,8 +140,8 @@
 should contain a single element pairing @samp{"."} with the appropriate
 directory name.
 
-If this variable is @code{nil}, or it fails to match a filename, the
-backup is made in the original file's directory.
+If this variable is @code{nil} (the default), or it fails to match a
+filename, the backup is made in the original file's directory.
 
 On MS-DOS filesystems without long names this variable is always
 ignored.
@@ -192,7 +192,7 @@
 
 @defopt backup-by-copying
 If this variable is address@hidden, Emacs always makes backup files by
-copying.
+copying.  The default is @code{nil}.
 @end defopt
 
   The following three variables, when address@hidden, cause the second
@@ -201,7 +201,7 @@
 
 @defopt backup-by-copying-when-linked
 If this variable is address@hidden, Emacs makes backups by copying for
-files with multiple names (hard links).
+files with multiple names (hard links).  The default is @code{nil}.
 
 This variable is significant only if @code{backup-by-copying} is
 @code{nil}, since copying is always used when that variable is
@@ -209,8 +209,9 @@
 @end defopt
 
 @defopt backup-by-copying-when-mismatch
-If this variable is address@hidden, Emacs makes backups by copying in cases
-where renaming would change either the owner or the group of the file.
+If this variable is address@hidden (the default), Emacs makes backups
+by copying in cases where renaming would change either the owner or
+the group of the file.
 
 The value has no effect when renaming would not alter the owner or
 group of the file; that is, for files which are owned by the user and
@@ -442,10 +443,11 @@
 
 @deffn Command auto-save-mode arg
 When used interactively without an argument, this command is a toggle
-switch: it turns on auto-saving of the current buffer if it is off, and
-vice versa.  With an argument @var{arg}, the command turns auto-saving
-on if the value of @var{arg} is @code{t}, a nonempty list, or a positive
-integer.  Otherwise, it turns auto-saving off.
+switch: it turns on auto-saving of the current buffer if it is off,
+and vice versa.  When called from Lisp with no argument, it turns
+auto-saving on.  With an argument @var{arg}, it turns auto-saving on
+if the value of @var{arg} is @code{t}, a nonempty list, or a positive
+integer; otherwise, it turns auto-saving off.
 @end deffn
 
 @defun auto-save-file-name-p filename
@@ -755,3 +757,8 @@
 the modified contents---but only if @code{revert-buffer-function} is
 @code{nil}.
 @end defvar
+
address@hidden revert-buffer-in-progress-p
+This variable is bound to a address@hidden value by
address@hidden while it is working.
address@hidden defvar

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2012-02-24 19:25:38 +0000
+++ b/etc/NEWS  2012-02-25 09:32:33 +0000
@@ -302,9 +302,9 @@
 
 +++
 *** Emacs preserves the SELinux file context when backing up, and
-optionally when copying files. To this end, copy-file has an extra
-optional argument, and backup-buffer and friends include the SELinux
-context in their return values.
+optionally when copying files.  To this end, `copy-file' has an extra
+optional argument, and the return value of `backup-buffer' now
+includes the SELinux context.
 
 +++
 *** The new functions file-selinux-context and set-file-selinux-context
@@ -1019,6 +1019,14 @@
 
 * Incompatible Lisp Changes in Emacs 24.1
 
++++
+** The return value of `backup-buffer' has changed.
+It is now a list of three elements, where the second element is a list
+describing the original file's SELinux context.  If Emacs or the
+system lacks SELinux cupport, the context list is (nil nil nil nil).
+See the "Basic SELinux support" entry under "Changes in Emacs 24.1",
+above.
+
 ---
 ** `char-direction-table' and the associated function `char-direction'
 were deleted.  They were buggy and inferior to the new support of