]> git.ipfire.org Git - thirdparty/git.git/commitdiff
blame: describe default output format
authorBagas Sanjaya <bagasdotme@gmail.com>
Fri, 1 Oct 2021 11:37:25 +0000 (18:37 +0700)
committerJunio C Hamano <gitster@pobox.com>
Fri, 1 Oct 2021 22:44:32 +0000 (15:44 -0700)
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>
Documentation/git-blame.txt

index 34b496d4858134fb5c5e91bbd1537cd3ae076ccf..2406790ebf7bb7e88f34900b8f276f111586a09e 100644 (file)
@@ -93,6 +93,19 @@ include::blame-options.txt[]
        is used for a caret to mark the boundary commit.
 
 
+THE DEFAULT FORMAT
+------------------
+
+When neither `--porcelain` nor `--incremental` option is specified,
+`git blame` will output annotation for each line with:
+
+- abbreviated object name for the commit the line came from;
+- author ident (by default author name and date, unless `-s` or `-e`
+  is specified); and
+- line number
+
+before the line contents.
+
 THE PORCELAIN FORMAT
 --------------------