for-each-ref: accept "%(push)" format
[gitweb.git] / Documentation / blame-options.txt
index b0d31df0e750141fb8adc7a487c81663246ddf04..b299b5902360bdd9f784e5b3acdae3b558a6565a 100644 (file)
@@ -4,33 +4,20 @@
 
 --root::
        Do not treat root commits as boundaries.  This can also be
-       controlled via the `blame.showroot` config option.
+       controlled via the `blame.showRoot` config option.
 
 --show-stats::
        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).