aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorLars Ingebrigtsen2016-04-30 16:21:54 +0200
committerLars Ingebrigtsen2016-04-30 16:21:54 +0200
commite77b8d84b4161f2cf8720dec2bf44a3e50134398 (patch)
tree46ca324c6ff42df32cdb30bafa19e3af25f64bd6 /doc
parentc05d186455ce9907eeb6b21ea4227e453996c681 (diff)
downloademacs-e77b8d84b4161f2cf8720dec2bf44a3e50134398.tar.gz
emacs-e77b8d84b4161f2cf8720dec2bf44a3e50134398.zip
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).
Diffstat (limited to 'doc')
-rw-r--r--doc/emacs/files.texi25
1 files changed, 12 insertions, 13 deletions
diff --git a/doc/emacs/files.texi b/doc/emacs/files.texi
index bbb6070874f..af9d4d50306 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
522makes a backup from the previous contents, and arranges to make 522makes a backup from the previous contents, and arranges to make
523another from the newly saved contents if you save again. 523another from the newly saved contents if you save again.
524 524
525@vindex backup-directory-alist
526 You can customize the variable @code{backup-directory-alist} to
527specify that files matching certain patterns should be backed up in
528specific directories. A typical use is to add an element @code{("."
529. @var{dir})} to make all backups in the directory with absolute name
530@var{dir}. Emacs modifies the backup file names to avoid clashes
531between files with the same names originating in different
532directories. Alternatively, adding, @code{("." . ".~")} would make
533backups in the invisible subdirectory @file{.~} of the original file's
534directory. Emacs creates the directory, if necessary, to make the
535backup.
536
525@menu 537@menu
526* Names: Backup Names. How backup files are named. 538* Names: Backup Names. How backup files are named.
527* Deletion: Backup Deletion. Emacs deletes excess numbered backups. 539* Deletion: Backup Deletion. Emacs deletes excess numbered backups.
@@ -585,19 +597,6 @@ value is @samp{nil} or @samp{existing}, then @code{version-control}
585becomes @code{nil}; if it is @samp{never} or @samp{simple}, then 597becomes @code{nil}; if it is @samp{never} or @samp{simple}, then
586@code{version-control} becomes @code{never}. 598@code{version-control} becomes @code{never}.
587 599
588@vindex backup-directory-alist
589 You can customize the variable @code{backup-directory-alist} to
590specify that files matching certain patterns should be backed up in
591specific directories. This variable applies to both single and
592numbered backups. A typical use is to add an element @code{("."
593. @var{dir})} to make all backups in the directory with absolute name
594@var{dir}; Emacs modifies the backup file names to avoid clashes
595between files with the same names originating in different
596directories. Alternatively, adding, @code{("." . ".~")} would make
597backups in the invisible subdirectory @file{.~} of the original file's
598directory. Emacs creates the directory, if necessary, to make the
599backup.
600
601@vindex make-backup-file-name-function 600@vindex make-backup-file-name-function
602 If you set the variable @code{make-backup-file-name-function} to 601 If you set the variable @code{make-backup-file-name-function} to
603a suitable Lisp function, you can override the usual way Emacs 602a suitable Lisp function, you can override the usual way Emacs