Mercurial > hg > xemacs-beta

comparison man/lispref/backups.texi @ 5791:9fae6227ede5

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Silence texinfo 5.2 warnings, primarily by adding next, prev, and up pointers to all nodes. See xemacs-patches message with ID <5315f7bf.sHpFD7lXYR05GH6E%james@xemacs.org>.
author Jerry James <james@xemacs.org>
date Thu, 27 Mar 2014 08:59:03 -0600
parents 094487d1005d
children
comparison
equal deleted inserted replaced
5790:dcf9067f26bb 5791:9fae6227ede5
16 * Backup Files:: How backup files are made; how their names are chosen. 16 * Backup Files:: How backup files are made; how their names are chosen.
17 * Auto-Saving:: How auto-save files are made; how their names are chosen. 17 * Auto-Saving:: How auto-save files are made; how their names are chosen.
18 * Reverting:: @code{revert-buffer}, and how to customize what it does. 18 * Reverting:: @code{revert-buffer}, and how to customize what it does.
19 @end menu 19 @end menu
20 20
21 @node Backup Files 21 @node Backup Files, Auto-Saving, Backups and Auto-Saving, Backups and Auto-Saving
22 @section Backup Files 22 @section Backup Files
23 @cindex backup file 23 @cindex backup file
24 24
25 A @dfn{backup file} is a copy of the old contents of a file you are 25 A @dfn{backup file} is a copy of the old contents of a file you are
26 editing. XEmacs makes a backup file the first time you save a buffer 26 editing. XEmacs makes a backup file the first time you save a buffer
45 * Rename or Copy:: Two alternatives: renaming the old file or copying it. 45 * Rename or Copy:: Two alternatives: renaming the old file or copying it.
46 * Numbered Backups:: Keeping multiple backups for each source file. 46 * Numbered Backups:: Keeping multiple backups for each source file.
47 * Backup Names:: How backup file names are computed; customization. 47 * Backup Names:: How backup file names are computed; customization.
48 @end menu 48 @end menu
49 49
50 @node Making Backups 50 @node Making Backups, Rename or Copy, Backup Files, Backup Files
51 @subsection Making Backup Files 51 @subsection Making Backup Files
52 52
53 @defun backup-buffer 53 @defun backup-buffer
54 This function makes a backup of the file visited by the current 54 This function makes a backup of the file visited by the current
55 buffer, if appropriate. It is called by @code{save-buffer} before 55 buffer, if appropriate. It is called by @code{save-buffer} before
115 This is a permanent local, so that changing the major mode does not lose 115 This is a permanent local, so that changing the major mode does not lose
116 its value. Major modes should not set this variable---they should set 116 its value. Major modes should not set this variable---they should set
117 @code{make-backup-files} instead. 117 @code{make-backup-files} instead.
118 @end defvar 118 @end defvar
119 119
120 @node Rename or Copy 120 @node Rename or Copy, Numbered Backups, Making Backups, Backup Files
121 @subsection Backup by Renaming or by Copying? 121 @subsection Backup by Renaming or by Copying?
122 @cindex backup files, how to make them 122 @cindex backup files, how to make them
123 123
124 There are two ways that XEmacs can make a backup file: 124 There are two ways that XEmacs can make a backup file:
125 125
177 This variable is significant only if @code{backup-by-copying} is 177 This variable is significant only if @code{backup-by-copying} is
178 @code{nil}, since copying is always used when that variable is 178 @code{nil}, since copying is always used when that variable is
179 non-@code{nil}. 179 non-@code{nil}.
180 @end defvar 180 @end defvar
181 181
182 @node Numbered Backups 182 @node Numbered Backups, Backup Names, Rename or Copy, Backup Files
183 @subsection Making and Deleting Numbered Backup Files 183 @subsection Making and Deleting Numbered Backup Files
184 184
185 If a file's name is @file{foo}, the names of its numbered backup 185 If a file's name is @file{foo}, the names of its numbered backup
186 versions are @file{foo.~@var{v}~}, for various integers @var{v}, like 186 versions are @file{foo.~@var{v}~}, for various integers @var{v}, like
187 this: @file{foo.~1~}, @file{foo.~2~}, @file{foo.~3~}, @dots{}, 187 this: @file{foo.~1~}, @file{foo.~2~}, @file{foo.~3~}, @dots{},
237 in the Dired command @kbd{.} (@code{dired-clean-directory}). That's the 237 in the Dired command @kbd{.} (@code{dired-clean-directory}). That's the
238 same thing @code{kept-new-versions} specifies when you make a new backup 238 same thing @code{kept-new-versions} specifies when you make a new backup
239 file. The default value is 2. 239 file. The default value is 2.
240 @end defopt 240 @end defopt
241 241
242 @node Backup Names 242 @node Backup Names, , Numbered Backups, Backup Files
243 @subsection Naming Backup Files 243 @subsection Naming Backup Files
244 244
245 The functions in this section are documented mainly because you can 245 The functions in this section are documented mainly because you can
246 customize the naming conventions for backup files by redefining them. 246 customize the naming conventions for backup files by redefining them.
247 If you change one, you probably need to change the rest. 247 If you change one, you probably need to change the rest.
347 347
348 Some file comparison commands use this function so that they can 348 Some file comparison commands use this function so that they can
349 automatically compare a file with its most recent backup. 349 automatically compare a file with its most recent backup.
350 @end defun 350 @end defun
351 351
352 @node Auto-Saving 352 @node Auto-Saving, Reverting, Backup Files, Backups and Auto-Saving
353 @section Auto-Saving 353 @section Auto-Saving
354 @cindex auto-saving 354 @cindex auto-saving
355 355
356 XEmacs periodically saves all files that you are visiting; this is 356 XEmacs periodically saves all files that you are visiting; this is
357 called @dfn{auto-saving}. Auto-saving prevents you from losing more 357 called @dfn{auto-saving}. Auto-saving prevents you from losing more
571 The default name for this file is in your home directory and starts with 571 The default name for this file is in your home directory and starts with
572 @samp{.saves-}. It also contains the XEmacs process @sc{id} and the host 572 @samp{.saves-}. It also contains the XEmacs process @sc{id} and the host
573 name. 573 name.
574 @end defvar 574 @end defvar
575 575
576 @node Reverting 576 @node Reverting, , Auto-Saving, Backups and Auto-Saving
577 @section Reverting 577 @section Reverting
578 578
579 If you have made extensive changes to a file and then change your mind 579 If you have made extensive changes to a file and then change your mind
580 about them, you can get rid of them by reading in the previous version 580 about them, you can get rid of them by reading in the previous version
581 of the file with the @code{revert-buffer} command. @xref{Reverting, , 581 of the file with the @code{revert-buffer} command. @xref{Reverting, ,