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

Re: [PATCH] blame: document --color-* options

From
Bagas Sanjaya <bagasdotme@gmail.com>
Date
Sep 29, 2021, 09:15 UTC
Message-ID
<7745e157-7df9-2da7-f391-8c5bae16f005@gmail.com>
In-Reply-To
<xmqq4ka4n00h.fsf@gitster.g>
On 28/09/21 23.22, Junio C Hamano wrote:
Show 15 quoted lines
> Sorry for skipping a level of logical progression in the suggestion.
> 
> While I do not think we want to add another section for the default
> format, if we were to add such a section, the new description should
> use phrases that would have been used, and such a section would not
> use a new and unclear "metadata" in the description.  Instead it
> would use phrases that the users can look for elsewhere in the same
> documentation.
> 
> What is colored is the summary of the commit the line came from
> (abbreviated commit object name, plus the author name and time by
> default) plus the line number, I think.
> 
> Thanks.
> 

Stefan mentioned "metadata" term to describe the line annotation, from commit cdc2d5f11f1a:

Show 6 quoted lines
>     When using git-blame lots of lines contain redundant information, for
>     example in hunks that consist of multiple lines, the metadata (commit
>     name, author, date) are repeated. A reader may not be interested in those,
>     so offer an option to color the information that is repeated from the
>     previous line differently. Traditionally, we use CYAN for lines that
>     are less interesting than others (e.g. hunk header), so go with that.
-- 
An old man doll... just what I always wanted! - Clara
Previous: Junio C HamanoNext: Junio C Hamano
Message 13 of 14 in “git-blame: '--color-by-age' option not documented in manual page”
  1. Dr. Matthias St. PierreSep 24, 2021
  2. blame: document --color-* optionsBagas Sanjaya, Sep 25, 2021
  3. Bagas SanjayaSep 25, 2021
  4. Junio C HamanoSep 27, 2021
  5. Bagas SanjayaSep 28, 2021
  6. Dr. Matthias St. PierreSep 28, 2021
  7. Bagas SanjayaSep 29, 2021
  8. Dr. Matthias St. PierreSep 29, 2021
  9. Bagas SanjayaSep 29, 2021
  10. Dr. Matthias St. PierreSep 29, 2021
  11. Dr. Matthias St. PierreSep 29, 2021
  12. Junio C HamanoSep 28, 2021
  13. Bagas SanjayaSep 29, 2021
  14. 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.