git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH v2 1/2] blame: Describe default output format

From
Bagas Sanjaya <bagasdotme@gmail.com>
Date
Sep 29, 2021, 12:49 UTC
Message-ID
<20210929124935.41917-2-bagasdotme@gmail.com>
In-Reply-To
<20210929124935.41917-1-bagasdotme@gmail.com>

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>
---
 Documentation/git-blame.txt | 12 ++++++++++++
 1 file changed, 12 insertions(+)
diff --git a/Documentation/git-blame.txt b/Documentation/git-blame.txt
index 3bf5d5d8b4..284aa99942 100644
--- a/Documentation/git-blame.txt
+++ b/Documentation/git-blame.txt
@@ -93,6 +93,18 @@ 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 inline annotation for each line with:
+
+- abbreviated SHA-1 of the commit the line is attributed to;
+- author name (or author email if `-e` or `--show-email` is specified);
+- author date; and
+- line number
+
+
 THE PORCELAIN FORMAT
 --------------------
 
-- 
An old man doll... just what I always wanted! - Clara
Previous: Bagas SanjayaNext: Junio C Hamano
Message 2 of 5 in “blame: documentation update”
  1. 0/2 blame: documentation updateBagas Sanjaya, Sep 29, 2021
  2. 1/2 blame: Describe default output formatBagas Sanjaya, Sep 29, 2021
  3. Junio C HamanoSep 29, 2021
  4. 2/2 blame: document --color-* optionsBagas Sanjaya, Sep 29, 2021
  5. Junio C HamanoSep 29, 2021

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.