Re: diff-mode documentation

[Aaron S. Hawley]

On Thu, 9 Mar 2006, Richard Stallman wrote:

>     @item address@hidden
>     @findex diff-file-next
>     Move to the next file hunk in a multiple file patch.
>
> I think I can guess what a "file hunk" is.  Is it the part of the
> patch that is the diff for one file?

I'm glad you brought this up.  I'm not experienced with the common
terminology of patches, so I sort of "winged it".  A "file hunk" is indeed
the "diff" of a file.

>     @findex diff-file-kill
>     In a patch with multiple files, kill the current patch to a file.
>
> What does the "current patch to a file"?  Is it different from the
> current file hunk?

No, it's the same.

> I would rather these be C-c commands.
> [...]
>
>     @item M-A
>     @findex diff-ediff-patch
>     Start an Ediff session with the patch.
>     @xref{Top, Ediff, Ediff, ediff, The Ediff Manual}.
>
> Same story there.
>
>     @item M-K
>     @findex diff-file-kill
>     In a patch with multiple files, kill the current patch to a file.
>
> This would have to be moved.

I'll let Stefan take this up.