doc/git-show: include --diff-merges description
Move description of --diff-merges option from git-log.txt to diff-options.txt so that it is included in the git-show help. Signed-off-by: Sergey Organov <sorganov@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:

committed by
Junio C Hamano

parent
e58142add4
commit
1d24509b7b
@ -33,6 +33,57 @@ endif::git-diff[]
|
|||||||
show the patch by default, or to cancel the effect of `--patch`.
|
show the patch by default, or to cancel the effect of `--patch`.
|
||||||
endif::git-format-patch[]
|
endif::git-format-patch[]
|
||||||
|
|
||||||
|
ifdef::git-log[]
|
||||||
|
--diff-merges=(off|none|first-parent|1|separate|m|combined|c|dense-combined|cc)::
|
||||||
|
--no-diff-merges::
|
||||||
|
Specify diff format to be used for merge commits. Default is
|
||||||
|
{diff-merges-default} unless `--first-parent` is in use, in which case
|
||||||
|
`first-parent` is the default.
|
||||||
|
+
|
||||||
|
--diff-merges=(off|none):::
|
||||||
|
--no-diff-merges:::
|
||||||
|
Disable output of diffs for merge commits. Useful to override
|
||||||
|
implied value.
|
||||||
|
+
|
||||||
|
--diff-merges=first-parent:::
|
||||||
|
--diff-merges=1:::
|
||||||
|
This option makes merge commits show the full diff with
|
||||||
|
respect to the first parent only.
|
||||||
|
+
|
||||||
|
--diff-merges=separate:::
|
||||||
|
--diff-merges=m:::
|
||||||
|
-m:::
|
||||||
|
This makes merge commits show the full diff with respect to
|
||||||
|
each of the parents. Separate log entry and diff is generated
|
||||||
|
for each parent. `-m` doesn't produce any output without `-p`.
|
||||||
|
+
|
||||||
|
--diff-merges=combined:::
|
||||||
|
--diff-merges=c:::
|
||||||
|
-c:::
|
||||||
|
With this option, diff output for a merge commit shows the
|
||||||
|
differences from each of the parents to the merge result
|
||||||
|
simultaneously instead of showing pairwise diff between a
|
||||||
|
parent and the result one at a time. Furthermore, it lists
|
||||||
|
only files which were modified from all parents. `-c` implies
|
||||||
|
`-p`.
|
||||||
|
+
|
||||||
|
--diff-merges=dense-combined:::
|
||||||
|
--diff-merges=cc:::
|
||||||
|
--cc:::
|
||||||
|
With this option the output produced by
|
||||||
|
`--diff-merges=combined` is further compressed by omitting
|
||||||
|
uninteresting hunks whose contents in the parents have only
|
||||||
|
two variants and the merge result picks one of them without
|
||||||
|
modification. `--cc` implies `-p`.
|
||||||
|
|
||||||
|
--combined-all-paths::
|
||||||
|
This flag causes combined diffs (used for merge commits) to
|
||||||
|
list the name of the file from all parents. It thus only has
|
||||||
|
effect when `--diff-merges=[dense-]combined` is in use, and
|
||||||
|
is likely only useful if filename changes are detected (i.e.
|
||||||
|
when either rename or copy detection have been requested).
|
||||||
|
endif::git-log[]
|
||||||
|
|
||||||
-U<n>::
|
-U<n>::
|
||||||
--unified=<n>::
|
--unified=<n>::
|
||||||
Generate diffs with <n> lines of context instead of
|
Generate diffs with <n> lines of context instead of
|
||||||
|
@ -127,57 +127,8 @@ selected, nor will they match search options like `-S`. The exception
|
|||||||
is when `--first-parent` is in use, in which case `first-parent` is
|
is when `--first-parent` is in use, in which case `first-parent` is
|
||||||
the default format.
|
the default format.
|
||||||
|
|
||||||
--diff-merges=(off|none|first-parent|1|separate|m|combined|c|dense-combined|cc)::
|
|
||||||
--no-diff-merges::
|
|
||||||
Specify diff format to be used for merge commits. Default is
|
|
||||||
`off` unless `--first-parent` is in use, in which case
|
|
||||||
`first-parent` is the default.
|
|
||||||
+
|
|
||||||
--diff-merges=(off|none):::
|
|
||||||
--no-diff-merges:::
|
|
||||||
Disable output of diffs for merge commits. Useful to override
|
|
||||||
implied value.
|
|
||||||
+
|
|
||||||
--diff-merges=first-parent:::
|
|
||||||
--diff-merges=1:::
|
|
||||||
This option makes merge commits show the full diff with
|
|
||||||
respect to the first parent only.
|
|
||||||
+
|
|
||||||
--diff-merges=separate:::
|
|
||||||
--diff-merges=m:::
|
|
||||||
-m:::
|
|
||||||
This makes merge commits show the full diff with respect to
|
|
||||||
each of the parents. Separate log entry and diff is generated
|
|
||||||
for each parent. `-m` doesn't produce any output without `-p`.
|
|
||||||
+
|
|
||||||
--diff-merges=combined:::
|
|
||||||
--diff-merges=c:::
|
|
||||||
-c:::
|
|
||||||
With this option, diff output for a merge commit shows the
|
|
||||||
differences from each of the parents to the merge result
|
|
||||||
simultaneously instead of showing pairwise diff between a
|
|
||||||
parent and the result one at a time. Furthermore, it lists
|
|
||||||
only files which were modified from all parents. `-c` implies
|
|
||||||
`-p`.
|
|
||||||
+
|
|
||||||
--diff-merges=dense-combined:::
|
|
||||||
--diff-merges=cc:::
|
|
||||||
--cc:::
|
|
||||||
With this option the output produced by
|
|
||||||
`--diff-merges=combined` is further compressed by omitting
|
|
||||||
uninteresting hunks whose contents in the parents have only
|
|
||||||
two variants and the merge result picks one of them without
|
|
||||||
modification. `--cc` implies `-p`.
|
|
||||||
|
|
||||||
--combined-all-paths::
|
|
||||||
This flag causes combined diffs (used for merge commits) to
|
|
||||||
list the name of the file from all parents. It thus only has
|
|
||||||
effect when `--diff-merges=[dense-]combined` is in use, and
|
|
||||||
is likely only useful if filename changes are detected (i.e.
|
|
||||||
when either rename or copy detection have been requested).
|
|
||||||
|
|
||||||
|
|
||||||
:git-log: 1
|
:git-log: 1
|
||||||
|
:diff-merges-default: `off`
|
||||||
include::diff-options.txt[]
|
include::diff-options.txt[]
|
||||||
|
|
||||||
include::diff-generate-patch.txt[]
|
include::diff-generate-patch.txt[]
|
||||||
|
@ -45,10 +45,13 @@ include::pretty-options.txt[]
|
|||||||
include::pretty-formats.txt[]
|
include::pretty-formats.txt[]
|
||||||
|
|
||||||
|
|
||||||
COMMON DIFF OPTIONS
|
DIFF FORMATTING
|
||||||
-------------------
|
---------------
|
||||||
|
The options below can be used to change the way `git show` generates
|
||||||
|
diff output.
|
||||||
|
|
||||||
:git-log: 1
|
:git-log: 1
|
||||||
|
:diff-merges-default: `dense-combined`
|
||||||
include::diff-options.txt[]
|
include::diff-options.txt[]
|
||||||
|
|
||||||
include::diff-generate-patch.txt[]
|
include::diff-generate-patch.txt[]
|
||||||
|
Reference in New Issue
Block a user