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

[PATCH v4 0/2] blame: documentation update

From
Bagas Sanjaya <bagasdotme@gmail.com>
Date
Oct 3, 2021, 10:53 UTC
Message-ID
<20211003105327.215996-1-bagasdotme@gmail.com>

Document the default output format for git-blame(1), as well as the --color-* options which are currently undocumented but mentioned in usage help.

Changes since v3 [1]:
  - grammatical and wording fixes (suggested by Eric and Junio)
 
Bagas Sanjaya (2):
  blame: describe default output format
  blame: document --color-* options
 Documentation/blame-options.txt | 13 +++++++++++++
 Documentation/config/color.txt  | 33 ++++++++++++++++++---------------
 Documentation/git-blame.txt     | 17 +++++++++++++++--
 3 files changed, 46 insertions(+), 17 deletions(-)
Range-diff against v3:
1:  2478909d67 ! 1:  976c17a485 blame: Describe default output format
    @@ Metadata
     Author: Bagas Sanjaya <bagasdotme@gmail.com>
     
      ## Commit message ##
    -    blame: Describe default output format
    +    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
    @@ Documentation/git-blame.txt: include::blame-options.txt[]
     +`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
    ++- author ident (by default author name and date, unless `-s` or `-e` is
     +specified); and
     +- line number
     +
2:  a6f75786ec < -:  ---------- blame: document --color-* options
-:  ---------- > 2:  517dc2cb3d blame: document --color-* options

[1]: https://lore.kernel.org/git/20211001113725.13354-1-bagasdotme@gmail.com/T/#t

base-commit: cefe983a320c03d7843ac78e73bd513a27806845
-- 
An old man doll... just what I always wanted! - Clara
Next: Bagas Sanjaya
Message 1 of 3 in “blame: documentation update”
  1. 0/2 blame: documentation updateBagas Sanjaya, Oct 3, 2021
  2. 1/2 blame: describe default output formatBagas Sanjaya, Oct 3, 2021
  3. 2/2 blame: document --color-* optionsBagas Sanjaya, Oct 3, 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.