X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/8546720e6f25eb988e8215de6678798053031440..8a85c254de2528be0f3ff154fa24df65e6557c1a:/doc/emacs/emerge-xtra.texi diff --git a/doc/emacs/emerge-xtra.texi b/doc/emacs/emerge-xtra.texi index b46868cf52..bb39136d06 100644 --- a/doc/emacs/emerge-xtra.texi +++ b/doc/emacs/emerge-xtra.texi @@ -1,5 +1,5 @@ @c This is part of the Emacs manual. -@c Copyright (C) 2004-2011 Free Software Foundation, Inc. +@c Copyright (C) 2004-2014 Free Software Foundation, Inc. @c See file emacs.texi for copying conditions. @c @c This file is included either in emacs-xtra.texi (when producing the @@ -19,7 +19,7 @@ easier. For other ways to compare files, see @ifnottex @ref{Comparing Files}, @end ifnottex -and @ref{Top, Ediff,, ediff, The Ediff Manual}. +and @ref{Top,, Ediff, ediff, The Ediff Manual}. @menu * Overview of Emerge:: How to start Emerge. Basic concepts. @@ -151,17 +151,17 @@ input. The mode line indicates Auto Advance mode with @samp{A}. If Skip Prefers mode is in effect, the @kbd{n} and @kbd{p} commands skip over differences in states ``prefer-A'' and ``prefer-B'' (@pxref{State of Difference}). Thus you see only differences for -which neither version is presumed ``correct.'' The mode line +which neither version is presumed ``correct''. The mode line indicates Skip Prefers mode with @samp{S}. This mode is only relevant when there is an ancestor. -@findex emerge-auto-advance-mode -@findex emerge-skip-prefers-mode - Use the command @kbd{s a} (@code{emerge-auto-advance-mode}) to set or -clear Auto Advance mode. Use @kbd{s s} -(@code{emerge-skip-prefers-mode}) to set or clear Skip Prefers mode. -These commands turn on the mode with a positive argument, turn it off -with a negative or zero argument, and toggle the mode with no argument. +@findex emerge-auto-advance +@findex emerge-skip-prefers + Use the command @kbd{s a} (@code{emerge-auto-advance}) to set or clear +Auto Advance mode. Use @kbd{s s} (@code{emerge-skip-prefers}) to set or +clear Skip Prefers mode. These commands turn on the mode with a +positive argument, turn it off with a negative or zero argument, and +toggle the mode with no argument. @node State of Difference @subsection State of a Difference @@ -186,12 +186,12 @@ haven't made a choice. All differences start in the default-A state which one alternative is ``preferred'' (see below). When you select a difference, its state changes from default-A or -default-B to plain A or B. Thus, the selected difference never has +default-B to plain A or B@. Thus, the selected difference never has state default-A or default-B, and these states are never displayed in the mode line. The command @kbd{d a} chooses default-A as the default state, and @kbd{d -b} chooses default-B. This chosen default applies to all differences +b} chooses default-B@. This chosen default applies to all differences that you have never selected and for which no alternative is preferred. If you are moving through the merge sequentially, the differences you haven't selected are those following the selected one. Thus, while @@ -362,9 +362,9 @@ like this: @example @group #ifdef NEW -@var{version from A buffer} -#else /* not NEW */ @var{version from B buffer} +#else /* not NEW */ +@var{version from A buffer} #endif /* not NEW */ @end group @end example @@ -375,12 +375,12 @@ While this example shows C preprocessor conditionals delimiting the two alternative versions, you can specify the strings to use by setting the variable @code{emerge-combine-versions-template} to a string of your choice. In the string, @samp{%a} says where to put version A, and -@samp{%b} says where to put version B. The default setting, which +@samp{%b} says where to put version B@. The default setting, which produces the results shown above, looks like this: @example @group -"#ifdef NEW\n%a#else /* not NEW */\n%b#endif /* not NEW */\n" +"#ifdef NEW\n%b#else /* not NEW */\n%a#endif /* not NEW */\n" @end group @end example