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

[Richard M. Stallman]

Index: emacs/man/misc.texi
diff -u emacs/man/misc.texi:1.81 emacs/man/misc.texi:1.82
--- emacs/man/misc.texi:1.81    Wed Apr 19 21:27:28 2006
+++ emacs/man/misc.texi Tue May  2 01:41:04 2006
@@ -1761,7 +1761,7 @@
   Many of the sort commands ignore case differences when comparing, if
 @code{sort-fold-case} is address@hidden
 
address@hidden Narrowing, Two-Column, Sorting, Top
address@hidden Narrowing, Diff Mode, Sorting, Top
 @section Narrowing
 @cindex widening
 @cindex restriction
@@ -1827,7 +1827,86 @@
 if you enable the command, confirmation will no longer be required for
 it.  @xref{Disabling}.
 
address@hidden Two-Column, Editing Binary Files, Narrowing, Top
address@hidden Diff Mode, Two-Column, Narrowing, Top
address@hidden Diff Mode
address@hidden Diff mode
+
+  Diff mode is useful for editing patches and comparisons produced by
+the @command{diff} program.  You can select Diff mode by typing
address@hidden diff-mode}; Emacs commands that compare files automatically
+select Diff mode.  @xref{Top,, Diff, diff, Comparing and Merging Files},
+for more information about @command{diff} output formats.
+
+  One general feature of Diff mode is that manual edits to the patch
+automatically correct line numbers, including those in the hunk
+header, so that you can actually apply the edited patch.  Diff mode
+also provides the following commands to navigate, manipulate and apply
+parts of patches:
+
address@hidden @kbd
address@hidden M-n
+Move to the next hunk-start (@code{diff-hunk-next}).
+
address@hidden M-p
+Move to the previous hunk-start (@code{diff-hunk-prev}).
+
address@hidden address@hidden
+Move to the next file-start, in a multi-file patch
+(@code{diff-file-next}).
+
address@hidden address@hidden
+Move to the previous file-start, in a multi-file patch
+(@code{diff-file-prev}).
+
address@hidden M-k
+Kill the hunk at point (@code{diff-hunk-kill}).
+
address@hidden M-K
+In a multi-file patch, kill the current file part.
+(@code{diff-file-kill}).
+
address@hidden C-c C-a
+Apply this hunk to its target file (@code{diff-apply-hunk}).  With a
+prefix argument of @kbd{C-u}, revert this hunk.
+
address@hidden C-c C-c
+Go to the source corresponding to this hunk (@code{diff-goto-source}).
+
address@hidden C-c C-e
+Start an Ediff session with the patch (@code{diff-ediff-patch}).
address@hidden, Ediff, Ediff, ediff, The Ediff Manual}.
+
address@hidden C-c C-n
+Restrict the view to the current hunk (@code{diff-restrict-view}).
address@hidden  With a prefix argument of @kbd{C-u}, restrict the
+view to the current patch of a multiple file patch.  To widen again,
+use @kbd{C-x n w}.
+
address@hidden C-c C-r
+Reverse the direction of comparison for the entire buffer
+(@code{diff-reverse-direction}).
+
address@hidden C-c C-s
+Split the hunk at point (@code{diff-split-hunk}).  This is for
+manually editing patches, and only works with the unified diff format.
+
address@hidden C-c C-u
+Convert the entire buffer to unified format
+(@code{diff-context->unified}).  With a prefix argument, convert
+unified format to context format.  In Transient Mark mode, when the
+mark is active, this command operates only on the region.
+
address@hidden C-c C-w
+Refine the current hunk so that it disregards changes in whitespace
+(@code{diff-refine-hunk}).
address@hidden table
+
+  @kbd{C-x 4 a} in Diff mode operates on behalf of the target file,
+but gets the function name from the patch itself.  @xref{Change Log}.
+This is useful for making log entries for functions that are deleted
+by the patch.
+
address@hidden Two-Column, Editing Binary Files, Diff Mode, Top
 @section Two-Column Editing
 @cindex two-column editing
 @cindex splitting columns