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

From: Junio C Hamano <[email-masked]>
Date: Mon, 27 Sep 2021 12:44:14 -0700

Bagas Sanjaya <[email-masked]> writes:

> diff --git a/Documentation/blame-options.txt b/Documentation/blame-options.txt
> index 117f4cf806..b15999a3c8 100644
> --- a/Documentation/blame-options.txt
> +++ b/Documentation/blame-options.txt
> @@ -136,5 +136,13 @@ take effect.
>  	option.  An empty file name, `""`, will clear the list of revs from
>  	previously processed files.
>  
> +--color-lines::
> +	Color lines that contain repeated metadata. The color used is set with
> +	`color.blame.repeatedLines` config option.
> +
> +--color-by-age::
> +	Color metadata depending on age of the line. `color.blame.highlightRecent`
> +	config option controls what color is used for each range of age.

Nowhere in "git blame --help" output we mention anything about
"metadata", so the readers of this new description will be left
puzzled what the word means in the context of this command.

We would need to pick words or phrases that readers can link easily
with the description of "THE PORCELAIN FORMAT" section.

Thanks.