[Top][All Lists]
[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
- [Emacs-diffs] Changes to emacs/man/files.texi, Richard M. Stallman, 2006/05/03
- [Emacs-diffs] Changes to emacs/man/files.texi, Eli Zaretskii, 2006/05/05
- [Emacs-diffs] Changes to emacs/man/files.texi, Richard M. Stallman, 2006/05/05
- [Emacs-diffs] Changes to emacs/man/files.texi,
Eli Zaretskii <=
- [Emacs-diffs] Changes to emacs/man/files.texi, Eli Zaretskii, 2006/05/06
- [Emacs-diffs] Changes to emacs/man/files.texi, Eli Zaretskii, 2006/05/06
- [Emacs-diffs] Changes to emacs/man/files.texi, Eli Zaretskii, 2006/05/12
- [Emacs-diffs] Changes to emacs/man/files.texi, Richard M. Stallman, 2006/05/17
- [Emacs-diffs] Changes to emacs/man/files.texi, Eli Zaretskii, 2006/05/20