blame: describe default output format
While there is descriptions for porcelain and incremental output formats, the default format isn't described. Describe that format for the sake of completeness. Signed-off-by: Bagas Sanjaya <bagasdotme@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Bagas Sanjaya committed
Oct 1, 2021 at 18:37 UTC
38c356aad6c9805ce766e44067c18a1894eb7d62
1 file changed
+13
Documentation/git-blame.txt
+13
@@ -93,6 +93,19 @@ include::blame-options.txt[]
93
is used for a caret to mark the boundary commit.
94
95
96
+THE DEFAULT FORMAT
97
+------------------
98
+
99
+When neither `--porcelain` nor `--incremental` option is specified,
100
+`git blame` will output annotation for each line with:
101
+
102
+- abbreviated object name for the commit the line came from;
103
+- author ident (by default author name and date, unless `-s` or `-e`
104
+ is specified); and
105
+- line number
106
+
107
+before the line contents.
108
+
109
THE PORCELAIN FORMAT
110
--------------------
111