kernel
/
git
mirror of https://git.kernel.org/pub/scm/git/git.git
1
0
Fork 0
Code Releases Activity

blame: document multiple -L support 

Signed-off-by: Eric Sunshine <sunshine@sunshineco.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
maint
Eric Sunshine 2013-08-06 09:59:40 -04:00 committed by Junio C Hamano
parent 91b5494e18
commit 5bd9b79a20
2 changed files with 12 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
Documentation/blame-options.txt
View File

@ -11,9 +11,11 @@


-L <start>,<end>:: -L <start>,<end>::
-L :<regex>:: -L :<regex>::
Annotate only the given line range. <start> and <end> are optional. Annotate only the given line range. May be specified multiple times.
``-L <start>'' or ``-L <start>,'' spans from <start> to end of file. Overlapping ranges are allowed.
``-L ,<end>'' spans from start of file to <end>. +
<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>.
+ +
include::line-range-format.txt[] include::line-range-format.txt[]



10
Documentation/git-blame.txt
View File

@ -9,7 +9,7 @@ SYNOPSIS
-------- --------
[verse] [verse]
'git blame' [-c] [-b] [-l] [--root] [-t] [-f] [-n] [-s] [-e] [-p] [-w] [--incremental] 'git blame' [-c] [-b] [-l] [--root] [-t] [-f] [-n] [-s] [-e] [-p] [-w] [--incremental]
[-L n,m | -L :fn] [-S <revs-file>] [-M] [-C] [-C] [-C] [--since=<date>] [-L <range>] [-S <revs-file>] [-M] [-C] [-C] [-C] [--since=<date>]
[--abbrev=<n>] [<rev> | --contents <file> | --reverse <rev>] [--] <file> [--abbrev=<n>] [<rev> | --contents <file> | --reverse <rev>] [--] <file>


DESCRIPTION DESCRIPTION
@ -18,7 +18,8 @@ DESCRIPTION
Annotates each line in the given file with information from the revision which Annotates each line in the given file with information from the revision which
last modified the line. Optionally, start annotating from the given revision. last modified the line. Optionally, start annotating from the given revision.


The command can also limit the range of lines annotated. When specified one or more times, `-L` restricts annotation to the requested
lines.


The origin of lines is automatically followed across whole-file The origin of lines is automatically followed across whole-file
renames (currently there is no option to turn the rename-following renames (currently there is no option to turn the rename-following
@ -130,7 +131,10 @@ SPECIFYING RANGES


Unlike 'git blame' and 'git annotate' in older versions of git, the extent Unlike 'git blame' and 'git annotate' in older versions of git, the extent
of the annotation can be limited to both line ranges and revision of the annotation can be limited to both line ranges and revision
ranges. When you are interested in finding the origin for ranges. The `-L` option, which limits annotation to a range of lines, may be
specified multiple times.

When you are interested in finding the origin for
lines 40-60 for file `foo`, you can use the `-L` option like so lines 40-60 for file `foo`, you can use the `-L` option like so
(they mean the same thing -- both ask for 21 lines starting at (they mean the same thing -- both ask for 21 lines starting at
line 40): line 40):