From e77b8d84b4161f2cf8720dec2bf44a3e50134398 Mon Sep 17 00:00:00 2001 From: Lars Ingebrigtsen Date: Sat, 30 Apr 2016 16:21:54 +0200 Subject: [PATCH 1/1] 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). --- doc/emacs/files.texi | 25 ++++++++++++------------- 1 file changed, 12 insertions(+), 13 deletions(-) diff --git a/doc/emacs/files.texi b/doc/emacs/files.texi index bbb6070874..af9d4d5030 100644 --- a/doc/emacs/files.texi +++ b/doc/emacs/files.texi @@ -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 -- 2.39.2