blame: document multiple -L support
Signed-off-by: Eric Sunshine <sunshine@sunshineco.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Eric Sunshine committed
Aug 6, 2013 at 09:59 UTC
5bd9b79a2017daad1d600978b75c714eef74cac0
2 files changed
+12
-6
Documentation/blame-options.txt
+5
-3
@@ -11,9 +11,11 @@
11
12
-L <start>,<end>::
13
-L :<regex>::
14
- Annotate only the given line range. <start> and <end> are optional.
15
- ``-L <start>'' or ``-L <start>,'' spans from <start> to end of file.
16
- ``-L ,<end>'' spans from start of file to <end>.
14
+ Annotate only the given line range. May be specified multiple times.
15
+ Overlapping ranges are allowed.
16
++
17
+<start> and <end> are optional. ``-L <start>'' or ``-L <start>,'' spans from
18
+<start> to end of file. ``-L ,<end>'' spans from start of file to <end>.
19
+
20
include::line-range-format.txt[]
21
Documentation/git-blame.txt
+7
-3
@@ -9,7 +9,7 @@ SYNOPSIS
9
--------
10
[verse]
11
'git blame' [-c] [-b] [-l] [--root] [-t] [-f] [-n] [-s] [-e] [-p] [-w] [--incremental]
12
- [-L n,m | -L :fn] [-S <revs-file>] [-M] [-C] [-C] [-C] [--since=<date>]
12
+ [-L <range>] [-S <revs-file>] [-M] [-C] [-C] [-C] [--since=<date>]
13
[--abbrev=<n>] [<rev> | --contents <file> | --reverse <rev>] [--] <file>
14
15
DESCRIPTION
@@ -18,7 +18,8 @@ DESCRIPTION
18
Annotates each line in the given file with information from the revision which
19
last modified the line. Optionally, start annotating from the given revision.
20
21
-The command can also limit the range of lines annotated.
21
+When specified one or more times, `-L` restricts annotation to the requested
22
+lines.
23
24
The origin of lines is automatically followed across whole-file
25
renames (currently there is no option to turn the rename-following
@@ -130,7 +131,10 @@ SPECIFYING RANGES
131
132
Unlike 'git blame' and 'git annotate' in older versions of git, the extent
133
of the annotation can be limited to both line ranges and revision
133
-ranges. When you are interested in finding the origin for
134
+ranges. The `-L` option, which limits annotation to a range of lines, may be
135
+specified multiple times.
136
+
137
+When you are interested in finding the origin for
138
lines 40-60 for file `foo`, you can use the `-L` option like so
139
(they mean the same thing -- both ask for 21 lines starting at
140
line 40):