[PATCH v2 3/8] blame-options.txt: also mention 'funcname' in '-L' description
- From
Philippe Blain via GitGitGadget <gitgitgadget@gmail.com>
- Date
- Nov 1, 2020, 17:28 UTC
- Message-ID
- <d38f0f7e268897effa200a4c61c03d5cf082eb13.1604251728.git.gitgitgadget@gmail.com>
- In-Reply-To
- <pull.774.v2.git.1604251727.gitgitgadget@gmail.com>
From: Philippe Blain <levraiphilippeblain@gmail.com>
Make it clearer that a function can be blamed by feeding `git blame` '-L :<funcname>' by mentioning it at the beginnning of the description of the '-L' option.
Also, in 'line-range-options.txt', which is used for git-log(1) and gitk(1), do not parenthesize the mention of the ':<funcname>' mode, to place it on equal footing with the '<start>,<end>' mode.
Signed-off-by: Philippe Blain <levraiphilippeblain@gmail.com> --- Documentation/blame-options.txt | 5 +++-- Documentation/line-range-options.txt | 4 ++-- 2 files changed, 5 insertions(+), 4 deletions(-)
diff --git a/Documentation/blame-options.txt b/Documentation/blame-options.txt index 48bf0eeec5..dc3bceb6d1 100644 --- a/Documentation/blame-options.txt +++ b/Documentation/blame-options.txt @@ -11,8 +11,9 @@ -L <start>,<end>:: -L :<funcname>:: - Annotate only the given line range. May be specified multiple times. - Overlapping ranges are allowed. + Annotate only the line range given by '<start>,<end>', + or by the function name regex '<funcname>'. + May be specified multiple times. Overlapping ranges are allowed. + '<start>' and '<end>' are optional. `-L <start>` or `-L <start>,` spans from '<start>' to end of file. `-L ,<end>` spans from start of file to '<end>'. diff --git a/Documentation/line-range-options.txt b/Documentation/line-range-options.txt index 1c90127300..8e295a62b8 100644 --- a/Documentation/line-range-options.txt +++ b/Documentation/line-range-options.txt @@ -1,8 +1,8 @@ -L<start>,<end>:<file>:: -L:<funcname>:<file>:: - Trace the evolution of the line range given by '<start>,<end>' - (or the function name regex '<funcname>') within the '<file>'. You may + Trace the evolution of the line range given by '<start>,<end>', + or by the function name regex '<funcname>', within the '<file>'. You may not give any pathspec limiters. This is currently limited to a walk starting from a single revision, i.e., you may only give zero or one positive revision arguments, and
-- gitgitgadget