Merge branch 'mg/detached-head-report'
[gitweb.git] / Documentation / blame-options.txt
index b0d31df0e750141fb8adc7a487c81663246ddf04..0cebc4f6927211ffbc013de9368f03f480dba65d 100644 (file)
        Include additional statistics at the end of blame output.
 
 -L <start>,<end>::
-       Annotate only the given line range.  <start> and <end> can take
-       one of these forms:
-
-       - number
-+
-If <start> or <end> is a number, it specifies an
-absolute line number (lines count from 1).
-+
-
-- /regex/
-+
-This form will use the first line matching the given
-POSIX regex.  If <end> is a regex, it will search
-starting at the line given by <start>.
-+
-
-- +offset or -offset
+-L :<regex>::
+       Annotate only the given line range. May be specified multiple times.
+       Overlapping ranges are allowed.
 +
-This is only valid for <end> and will specify a number
-of lines before or after the line given by <start>.
+<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[]
 
 -l::
        Show long rev (Default: off).