aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorLars Ingebrigtsen2016-04-30 16:21:54 +0200
committerLars Ingebrigtsen2016-05-01 19:27:12 +0200
commit619f1edec7b14790090c05a2dcddf37253b06bfe (patch)
tree00eb3ff717032237fba771b6998c4cde74f20fb3
parent0846f21b77d38a568c4ceb143504472a2dd51aee (diff)
downloademacs-619f1edec7b14790090c05a2dcddf37253b06bfe.tar.gz
emacs-619f1edec7b14790090c05a2dcddf37253b06bfe.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). (cherry picked from commit e77b8d84b4161f2cf8720dec2bf44a3e50134398)
-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 ab20d4a18f9..af7a2fc2f3d 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