line-range-format.txt: clarify -L:regex usage form
blame/log documentation describes -L option as: -L<start>,<end> -L:<regex> <start> and <end> can take one of these forms: * number * /regex/ * +offset or -offset * :regex which is incorrect and confusing since :regex is not one of the valid forms of <start> or <end>; in fact, it must be -L's lone argument. Clarify by discussing :<regex> at the same indentation level as "<start> and <end>...": -L<start>,<end> -L:<regex> <start> and <end> can take one of these forms: * number * /regex/ * +offset or -offset If :<regex> is given in place of <start> and <end> ... 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
0ddd47193c225a9f7a658682d4e859771b45ab84
3 files changed
+3
-8
Documentation/blame-options.txt
-2
@@ -15,8 +15,6 @@
15
``-L <start>'' or ``-L <start>,'' spans from <start> to end of file.
16
``-L ,<end>'' spans from start of file to <end>.
17
+
18
-<start> and <end> can take one of these forms:
19
-
18
include::line-range-format.txt[]
19
20
-l::
Documentation/git-log.txt
-2
@@ -72,8 +72,6 @@ produced by --stat etc.
72
give zero or one positive revision arguments.
73
You can specify this option more than once.
74
+
75
-<start> and <end> can take one of these forms:
76
-
75
include::line-range-format.txt[]
76
77
<revision range>::
Documentation/line-range-format.txt
+3
-4
@@ -1,3 +1,5 @@
1
+<start> and <end> can take one of these forms:
2
+
3
- number
4
+
5
If <start> or <end> is a number, it specifies an
@@ -15,11 +17,8 @@ starting at the line given by <start>.
17
+
18
This is only valid for <end> and will specify a number
19
of lines before or after the line given by <start>.
18
-+
20
20
-- :regex
21
+
22
-If the option's argument is of the form :regex, it denotes the range
22
+If ``:<regex>'' is given in place of <start> and <end>, it denotes the range
23
from the first funcname line that matches <regex>, up to the next
24
funcname line.
25
-+