1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-15 10:30:25 -08:00

Move doc of backup-directory-alist to the Backup node

* doc/emacs/files.texi (Backup): Move the documentation of
`backup-directory-alist' here from the "Single or Numbered
Backups" node, because it doesn't seem to have much to do with
numbering (bug#18692).
This commit is contained in:
Lars Ingebrigtsen 2016-04-30 16:21:54 +02:00
parent c05d186455
commit e77b8d84b4

View file

@ -522,6 +522,18 @@ a new backup file. @kbd{C-u C-u C-u C-x C-s} does both things: it
makes a backup from the previous contents, and arranges to make
another from the newly saved contents if you save again.
@vindex backup-directory-alist
You can customize the variable @code{backup-directory-alist} to
specify that files matching certain patterns should be backed up in
specific directories. A typical use is to add an element @code{("."
. @var{dir})} to make all backups in the directory with absolute name
@var{dir}. Emacs modifies the backup file names to avoid clashes
between files with the same names originating in different
directories. Alternatively, adding, @code{("." . ".~")} would make
backups in the invisible subdirectory @file{.~} of the original file's
directory. Emacs creates the directory, if necessary, to make the
backup.
@menu
* Names: Backup Names. How backup files are named.
* Deletion: Backup Deletion. Emacs deletes excess numbered backups.
@ -585,19 +597,6 @@ value is @samp{nil} or @samp{existing}, then @code{version-control}
becomes @code{nil}; if it is @samp{never} or @samp{simple}, then
@code{version-control} becomes @code{never}.
@vindex backup-directory-alist
You can customize the variable @code{backup-directory-alist} to
specify that files matching certain patterns should be backed up in
specific directories. This variable applies to both single and
numbered backups. A typical use is to add an element @code{("."
. @var{dir})} to make all backups in the directory with absolute name
@var{dir}; Emacs modifies the backup file names to avoid clashes
between files with the same names originating in different
directories. Alternatively, adding, @code{("." . ".~")} would make
backups in the invisible subdirectory @file{.~} of the original file's
directory. Emacs creates the directory, if necessary, to make the
backup.
@vindex make-backup-file-name-function
If you set the variable @code{make-backup-file-name-function} to
a suitable Lisp function, you can override the usual way Emacs