Documentation/log: clarify what --raw means
There are several "raw formats", and describing --raw as "Generate the raw format" in the documentation for git-log seems to imply that it generates the raw *log* format. Clarify the wording by saying "raw diff format" explicitly, and make a special-case for "git log": "git log --raw" does not just change the format, it shows something which is not shown by default. Signed-off-by: Matthieu Moy <Matthieu.Moy@imag.fr> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Matthieu Moy committed
May 18, 2015 at 19:55 UTC
d89df367f61e8da1ae05ef7054bab4343eb67cdf
1 file changed
+10
-1
Documentation/diff-options.txt
+10
-1
@@ -41,8 +41,17 @@ endif::git-format-patch[]
41
42
ifndef::git-format-patch[]
43
--raw::
44
- Generate the raw format.
44
+ifndef::git-log[]
45
+ Generate the diff in raw format.
46
{git-diff-core? This is the default.}
47
+endif::git-log[]
48
+ifdef::git-log[]
49
+ For each commit, show a summary of changes using the raw diff
50
+ format. See the "RAW OUTPUT FORMAT" section of
51
+ linkgit:git-diff[1]. This is different from showing the log
52
+ itself in raw format, which you can achieve with
53
+ `--format=raw`.
54
+endif::git-log[]
55
endif::git-format-patch[]
56
57
ifndef::git-format-patch[]