diff mbox series

[v1,5/5] doc/diff-options: document new --diff-merges features

Message ID 20210410171657.20159-6-sorganov@gmail.com (mailing list archive)
State New
Headers show
Series [v1,1/5] diff-merges: introduce --diff-merges=default | expand

Commit Message

Sergey Organov April 10, 2021, 5:16 p.m. UTC
Document changes in -m and --diff-merges=m semantics, as well as new
--diff-merges=default option.

Signed-off-by: Sergey Organov <sorganov@gmail.com>
 Documentation/diff-options.txt | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)
diff mbox series


diff --git a/Documentation/diff-options.txt b/Documentation/diff-options.txt
index aa2b5c11f20b..31e2bacf5252 100644
--- a/Documentation/diff-options.txt
+++ b/Documentation/diff-options.txt
@@ -34,7 +34,7 @@  endif::git-diff[]
 	Specify diff format to be used for merge commits. Default is
 	{diff-merges-default} unless `--first-parent` is in use, in which case
@@ -45,17 +45,24 @@  ifdef::git-log[]
 	Disable output of diffs for merge commits. Useful to override
 	implied value.
+	This option makes diff output for merge commits to be shown in
+	the default format. `-m` will produce the output only if `-p`
+	is given as well. The default format could be changed using
+	`log.diffMerges` configuration parameter, which default value
+	is `separate`.
 	This option makes merge commits show the full diff with
 	respect to the first parent only.
 	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`.
+	for each parent.