Skip to content

Commit abcbafe

Browse files
committed
Merge branch 'mm/log-format-raw-doc'
Clarify that "log --raw" and "log --format=raw" are unrelated concepts. * mm/log-format-raw-doc: Documentation/log: clarify sha1 non-abbreviation in log --raw Documentation/log: clarify what --raw means
2 parents 67f0b6f + 92de921 commit abcbafe

File tree

2 files changed

+14
-2
lines changed

2 files changed

+14
-2
lines changed

Documentation/diff-options.txt

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,10 +43,19 @@ endif::git-format-patch[]
4343

4444
ifndef::git-format-patch[]
4545
--raw::
46-
Generate the raw format.
46+
ifndef::git-log[]
47+
Generate the diff in raw format.
4748
ifdef::git-diff-core[]
4849
This is the default.
4950
endif::git-diff-core[]
51+
endif::git-log[]
52+
ifdef::git-log[]
53+
For each commit, show a summary of changes using the raw diff
54+
format. See the "RAW OUTPUT FORMAT" section of
55+
linkgit:git-diff[1]. This is different from showing the log
56+
itself in raw format, which you can achieve with
57+
`--format=raw`.
58+
endif::git-log[]
5059
endif::git-format-patch[]
5160

5261
ifndef::git-format-patch[]

Documentation/pretty-formats.txt

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -79,7 +79,10 @@ stored in the commit object. Notably, the SHA-1s are
7979
displayed in full, regardless of whether --abbrev or
8080
--no-abbrev are used, and 'parents' information show the
8181
true parent commits, without taking grafts or history
82-
simplification into account.
82+
simplification into account. Note that this format affects the way
83+
commits are displayed, but not the way the diff is shown e.g. with
84+
`git log --raw`. To get full object names in a raw diff format,
85+
use `--no-abbrev`.
8386

8487
* 'format:<string>'
8588
+

0 commit comments

Comments
 (0)