procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Update Backups chapter of Lisp manual.

Browse source 
* 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.
This commit is contained in:
Chong Yidong 2012-02-25 17:32:33 +08:00
parent fa74b241a3
commit d268b4fe42
4 changed files with 33 additions and 15 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
admin/FOR-RELEASE
View file

@ -184,7 +184,7 @@ abbrevs.texi
advice.texi cyd
anti.texi
back.texi
backups.texi
backups.texi cyd
buffers.texi
commands.texi cyd
compile.texi cyd

5
doc/lispref/ChangeLog
View file

@ -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).

27
doc/lispref/backups.texi
View file

@ -140,8 +140,8 @@ For the common case of all backups going into one directory, the alist
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 @@ significance). @xref{Saving Buffers}.
@defopt backup-by-copying
If this variable is non-@code{nil}, Emacs always makes backup files by
copying.
copying. The default is @code{nil}.
@end defopt
The following three variables, when non-@code{nil}, cause the second
@ -201,7 +201,7 @@ treatment of files that don't fall into the special cases.
@defopt backup-by-copying-when-linked
If this variable is non-@code{nil}, 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 @@ non-@code{nil}.
@end defopt
@defopt backup-by-copying-when-mismatch
If this variable is non-@code{nil}, Emacs makes backups by copying in cases
where renaming would change either the owner or the group of the file.
If this variable is non-@code{nil} (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 @@ buffer-auto-save-file-name
@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 @@ This normal hook is run by @code{revert-buffer} after inserting
the modified contents---but only if @code{revert-buffer-function} is
@code{nil}.
@end defvar
@defvar revert-buffer-in-progress-p
This variable is bound to a non-@code{nil} value by
@code{revert-buffer} while it is working.
@end defvar

14
etc/NEWS
View file

@ -302,9 +302,9 @@ This requires Emacs to be linked with libselinux at build time.
+++
*** 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 @@ for buffers with dead inferior processes has been generalized.
* 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