doc/git-log: move "Diff Formatting" from rev-list-options
authorJeff King <peff@peff.net>
Wed, 29 Jul 2020 20:11:16 +0000 (16:11 -0400)
committerJunio C Hamano <gitster@pobox.com>
Wed, 29 Jul 2020 20:44:03 +0000 (13:44 -0700)
commit6f2e02aeb004a2ecd6aec1732f4abeaf88fba4b9
treea43f9e98fe36e3ec7c758797a294eab833317e97
parent9ab89a2439064720cc790c4477b8e981832c43f5
doc/git-log: move "Diff Formatting" from rev-list-options

Our rev-list-options.txt include has a "Diff Formatting" section, but it
is ifndef'd out for all manpages except git-log. And a few bits of the
text are rather out of date.

We say "some of these options are specific to git-rev-list". That's
obviously silly since we (even before this patch) show the content only
for git-log. But moreover, it's not true; each of the listed options is
meaningful for other diff commands.

We also say "...however other diff options may be given. See git-diff-files
for more options." But there's no need to do so; git-log already has a
"Common Diff Options" section which includes diff-options.txt.

So let's move these options over to git-log and put them with the other
diff options, giving a single "diff" section for the git-log
documentation. We'll call it "Diff Formatting" but use the all-caps
top-level header to match its sibling sections. And we'll rewrite the
section intro to remove the useless bits and give a more generic
overview of the section which can be later extended.

Signed-off-by: Jeff King <peff@peff.net>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-log.txt
Documentation/rev-list-options.txt