[PATCH] blame: document --color-* options
- From
Bagas Sanjaya <bagasdotme@gmail.com>
- Date
- Sep 25, 2021, 12:18 UTC
- Message-ID
- <20210925121817.1089897-1-bagasdotme@gmail.com>
- In-Reply-To
- <d918fe0de6b04d8d848050d4aedbe060@ncp-e.com>
Commit cdc2d5f11f1a (builtin/blame: dim uninteresting metadata lines, 2018-04-23) and 25d5f52901f0 (builtin/blame: highlight recently changed lines, 2018-04-23) introduce --color-lines and --color-by-age options to git blame, respectively. While both options are mentioned in usage help, they aren't documented in git-blame(1). Document them.
Signed-off-by: Bagas Sanjaya <bagasdotme@gmail.com> --- Documentation/blame-options.txt | 8 ++++++++ Documentation/git-blame.txt | 4 ++-- 2 files changed, 10 insertions(+), 2 deletions(-)
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. + -h:: Show help message. diff --git a/Documentation/git-blame.txt b/Documentation/git-blame.txt index 3bf5d5d8b4..cfdbad030b 100644 --- a/Documentation/git-blame.txt +++ b/Documentation/git-blame.txt @@ -11,8 +11,8 @@ SYNOPSIS 'git blame' [-c] [-b] [-l] [--root] [-t] [-f] [-n] [-s] [-e] [-p] [-w] [--incremental] [-L <range>] [-S <revs-file>] [-M] [-C] [-C] [-C] [--since=<date>] [--ignore-rev <rev>] [--ignore-revs-file <file>] - [--progress] [--abbrev=<n>] [<rev> | --contents <file> | --reverse <rev>..<rev>] - [--] <file> + [--color-lines] [--color-by-age] [--progress] [--abbrev=<n>] + [<rev> | --contents <file> | --reverse <rev>..<rev>] [--] <file> DESCRIPTION ----------- base-commit: 99c99ed8259bf070cd8ae7b51a94904b7cf5c161
-- 2.25.1