emacs-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Emacs-diffs] Changes to emacs/man/files.texi


From: Eli Zaretskii
Subject: [Emacs-diffs] Changes to emacs/man/files.texi
Date: Sat, 06 May 2006 12:52:00 +0000

Index: emacs/man/files.texi
diff -u emacs/man/files.texi:1.142 emacs/man/files.texi:1.143
--- emacs/man/files.texi:1.142  Fri May  5 20:56:02 2006
+++ emacs/man/files.texi        Sat May  6 12:52:00 2006
@@ -25,6 +25,9 @@
 * Visiting::            Visiting a file prepares Emacs to edit the file.
 * Saving::              Saving makes your changes permanent.
 * Reverting::           Reverting cancels all the changes not saved.
address@hidden
+* Autorevert::          Auto Reverting non-file buffers.
address@hidden ifnottex
 * Auto Save::           Auto Save periodically protects against loss of data.
 * File Aliases::        Handling multiple names for one file.
 * Version Control::     Version control systems (RCS, CVS and SCCS).
@@ -521,8 +524,14 @@
 Control}), the variable @code{vc-make-backup-files} determines whether
 to make backup files.  By default it is @code{nil}, since backup files
 are redundant when you store all the previous versions in a version
-control system.  @xref{General VC Options,,,emacs-xtra, Specialized
-Emacs Features}.
+control system.
address@hidden
address@hidden VC Options,,,emacs-xtra, Specialized Emacs Features}.
address@hidden iftex
address@hidden
address@hidden VC Options}.
address@hidden ifnottex
+
 
   At your option, Emacs can keep either a single backup for each file,
 or make a series of numbered backup files for each file that you edit.
@@ -976,6 +985,10 @@
   @xref{VC Mode Line}, for Auto Revert peculiarities in buffers that
 visit files under version control.
 
address@hidden
address@hidden arevert-xtra.texi
address@hidden ifnottex
+
 @node Auto Save
 @section Auto-Saving: Protection Against Disasters
 @cindex Auto Save mode
@@ -1205,7 +1218,13 @@
 
   VC is enabled by default in Emacs.  To disable it, set the
 customizable variable @code{vc-handled-backends} to @code{nil}
address@hidden
 (@pxref{Customizing VC,,,emacs-xtra, Specialized Emacs Features}).
address@hidden iftex
address@hidden
+(@pxref{Customizing VC}).
address@hidden ifnottex
+
 
 @menu
 * Introduction to VC::  How version control works in general.
@@ -1214,6 +1233,12 @@
 * Old Versions::        Examining and comparing old versions.
 * Secondary VC Commands::    The commands used a little less frequently.
 * Branches::            Multiple lines of development.
address@hidden
+* Remote Repositories:: Efficient access to remote CVS servers.
+* Snapshots::           Sets of file versions treated as a unit.
+* Miscellaneous VC::    Various other commands and features of VC.
+* Customizing VC::      Variables that change VC's behavior.
address@hidden ifnottex
 @end menu
 
 @node Introduction to VC
@@ -1351,7 +1376,13 @@
   CVS normally allows each user to modify his own copy of the work file
 at any time, but requires merging with changes from other users at
 check-in time.  However, CVS can also be set up to require locking.
address@hidden
 (@pxref{CVS Options,,,emacs-xtra, Specialized Emacs Features}).
address@hidden iftex
address@hidden
+(@pxref{CVS Options}).
address@hidden ifnottex
+
 
 @node Types of Log File
 @subsubsection Types of Log File
@@ -1383,8 +1414,14 @@
 the entry in @file{ChangeLog}, then copy it to the log buffer when you
 check in the change.  Or you can write the entry in the log buffer
 while checking in the change, and later use the @kbd{C-x v a} command
-to copy it to @file{ChangeLog} (@pxref{Change Logs and
-VC,,,emacs-xtra, Specialized Emacs Features}).
+to copy it to @file{ChangeLog}
address@hidden
+(@pxref{Change Logs and VC,,,emacs-xtra, Specialized Emacs Features}).
address@hidden iftex
address@hidden
+(@pxref{Change Logs and VC}).
address@hidden ifnottex
+
 
 @node VC Mode Line
 @subsection Version Control and the Mode Line
@@ -1548,8 +1585,15 @@
 @cindex specific version control system
 Instead of the version number, you can also specify the name of a
 version control system.  This is useful when one file is being managed
-with two version control systems at the same time (@pxref{Local
-Version Control,,,emacs-xtra, Specialized Emacs Features}).
+with two version control systems at the same time
address@hidden
+(@pxref{Local Version Control,,,emacs-xtra, Specialized Emacs
+Features}).
address@hidden iftex
address@hidden
+(@pxref{Local Version Control}).
address@hidden ifnottex
+
 @end itemize
 
 @node Log Buffer
@@ -1571,16 +1615,27 @@
 entries for the file(s) concerned in the top entry in the ChangeLog
 and uses those paragraphs as the log text.  This text is only inserted
 if the top entry was made under your user name on the current date.
address@hidden
 @xref{Change Logs and VC,,,emacs-xtra, Specialized Emacs Features},
address@hidden iftex
address@hidden
address@hidden Logs and VC},
address@hidden ifnottex
 for the opposite way of working---generating ChangeLog entries from
 the revision control log.
 
   In the @samp{*VC-Log*} buffer, @kbd{C-c C-f} (@kbd{M-x
 log-edit-show-files}) shows the list of files to be committed in case
 you need to check that.  (This can be a list of more than one file if
-you use VC Dired mode or PCL-CVS.  @xref{VC Dired Mode,,,emacs-xtra,
-Specialized Emacs Features}, and @ref{Top, , About PCL-CVS, pcl-cvs,
-PCL-CVS --- The Emacs Front-End to CVS}.)
+you use VC Dired mode or PCL-CVS.
address@hidden
address@hidden Dired Mode,,,emacs-xtra, Specialized Emacs Features},
address@hidden iftex
address@hidden
address@hidden Dired Mode},
address@hidden ifnottex
+and @ref{Top, , About PCL-CVS, pcl-cvs, PCL-CVS --- The Emacs
+Front-End to CVS}.)
 
   When you have finished editing the log message, type @kbd{C-c C-c} to
 exit the buffer and commit the change.
@@ -1648,7 +1703,13 @@
   You can specify a checked-in version by its number; an empty input
 specifies the current contents of the work file (which may be different
 from all the checked-in versions).  You can also specify a snapshot name
-(@pxref{Snapshots,,,emacs-xtra, Specialized Emacs Features}) instead of one or 
both version numbers.
address@hidden
+(@pxref{Snapshots,,,emacs-xtra, Specialized Emacs Features})
address@hidden iftex
address@hidden
+(@pxref{Snapshots})
address@hidden ifnottex
+instead of one or both version numbers.
 
   If you supply a directory name instead of the name of a registered
 file, this command compares the two specified versions of all registered
@@ -1737,6 +1798,10 @@
 * Registering::         Putting a file under version control.
 * VC Status::           Viewing the VC status of files.
 * VC Undo::             Canceling changes before or after check-in.
address@hidden
+* VC Dired Mode::       Listing files managed by version control.
+* VC Dired Commands::   Commands to use in a VC Dired buffer.
address@hidden ifnottex
 @end menu
 
 @node Registering
@@ -1757,8 +1822,13 @@
 registered in a version control system, Emacs uses that system.  If
 there is more than one system in use for a directory, Emacs uses the
 one that appears first in @code{vc-handled-backends}
-(@pxref{Customizing VC,,,emacs-xtra, Specialized Emacs Features}).  On
-the other hand, if there are no files already registered, Emacs uses
address@hidden
+(@pxref{Customizing VC,,,emacs-xtra, Specialized Emacs Features}).
address@hidden iftex
address@hidden
+(@pxref{Customizing VC}).
address@hidden ifnottex
+On the other hand, if there are no files already registered, Emacs uses
 the first system from @code{vc-handled-backends} that could register
 the file (for example, you cannot register a file under CVS if its
 directory is not already part of a CVS tree); with the default value
@@ -1818,16 +1888,27 @@
 
 @item P
 Move to the log of the previous file, when the logs of multiple files
-are in the log buffer (@pxref{VC Dired Mode,,,emacs-xtra, Specialized
-Emacs Features}).  Otherwise, just move to the beginning of the log.  A
-numeric prefix argument is a repeat count, so @kbd{C-u 10 P} would
-move backward 10 files.
+are in the log buffer
address@hidden
+(@pxref{VC Dired Mode,,,emacs-xtra, Specialized Emacs Features}).
address@hidden iftex
address@hidden
+(@pxref{VC Dired Mode}).
address@hidden ifnottex
+Otherwise, just move to the beginning of the log.  A numeric prefix
+argument is a repeat count, so @kbd{C-u 10 P} would move backward 10
+files.
 
 @item N
 Move to the log of the next file, when the logs of multiple files are
-in the log buffer (@pxref{VC Dired Mode,,,emacs-xtra, Specialized
-Emacs Features}).  It also takes a numeric prefix argument as a repeat
-count.
+in the log buffer
address@hidden
+(@pxref{VC Dired Mode,,,emacs-xtra, Specialized Emacs Features}).
address@hidden iftex
address@hidden
+(@pxref{VC Dired Mode}).
address@hidden ifnottex
+It also takes a numeric prefix argument as a repeat count.
 
 @item f
 Visit the revision indicated at the current line, like typing @kbd{C-x
@@ -1881,11 +1962,16 @@
 erroneous check-in, fix the error, and check the file in again.
 
   When @kbd{C-x v c} does not revert the buffer, it unexpands all
-version control headers in the buffer instead (@pxref{Version
-Headers,,,emacs-xtra, Specialized Emacs Features}).  This is because
-the buffer no longer corresponds to any existing version.  If you
-check it in again, the check-in process will expand the headers
-properly for the new version number.
+version control headers in the buffer instead
address@hidden
+(@pxref{Version Headers,,,emacs-xtra, Specialized Emacs Features}).
address@hidden iftex
address@hidden
+(@pxref{Version Headers}).
address@hidden ifnottex
+This is because the buffer no longer corresponds to any existing
+version.  If you check it in again, the check-in process will expand
+the headers properly for the new version number.
 
   However, it is impossible to unexpand the RCS @address@hidden header
 automatically.  If you use that header feature, you have to unexpand it
@@ -1897,6 +1983,13 @@
 under CVS, because canceling versions is very dangerous and discouraged
 with CVS.
 
address@hidden
address@hidden vc1-xtra.texi needs extra level of lowering.
address@hidden
address@hidden vc1-xtra.texi
address@hidden
address@hidden ifnottex
+
 @node Branches
 @subsection Multiple Branches of a File
 @cindex branch (version control)
@@ -2075,10 +2168,15 @@
 records.
 
   This technique works reliably and automatically, provided that the
-source files contain RCS version headers (@pxref{Version
-Headers,,,emacs-xtra, Specialized Emacs Features}).  The headers enable
-Emacs to be sure, at all times, which version number is present in the
-work file.
+source files contain RCS version headers
address@hidden
+(@pxref{Version Headers,,,emacs-xtra, Specialized Emacs Features}).
address@hidden iftex
address@hidden
+(@pxref{Version Headers}).
address@hidden ifnottex
+The headers enable Emacs to be sure, at all times, which version
+number is present in the work file.
 
   If the files do not have version headers, you must instead tell Emacs
 explicitly in each session which branch you are working on.  To do this,
@@ -2086,6 +2184,10 @@
 branch number.  This ensures that Emacs knows which branch it is using
 during this particular editing session.
 
address@hidden
address@hidden vc2-xtra.texi
address@hidden ifnottex
+
 @node Directories
 @section File Directories
 
@@ -2208,8 +2310,14 @@
 mode provides commands to resolve conflicts by selecting specific
 changes.
 
-  @inforef{Emerge,, emacs-xtra} for the Emerge facility, which
-provides a powerful interface for merging files.
address@hidden
address@hidden,,, emacs-xtra},
address@hidden iftex
address@hidden
address@hidden,
address@hidden ifnottex
+for the Emerge facility, which provides a powerful interface for
+merging files.
 
 @node Diff Mode
 @section Diff Mode




reply via email to

[Prev in Thread] Current Thread [Next in Thread]