From: Andrew Ruder <andy@aeruder.net>
Date: Fri, 27 Apr 2007 04:58:59 +0000 (-0500)
Subject: Update -L documentation for git-blame/git-annotate
X-Git-Tag: v1.5.1.3~18
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=a44f88e251a82c32dcc4715f063e3e3e39562a8d;p=git.git

Update -L documentation for git-blame/git-annotate

Documenting alternate ways to use -L:

-L /regex/,end
-L start,+offset

Signed-off-by: Andrew Ruder <andy@aeruder.net>
Signed-off-by: Junio C Hamano <junkio@cox.net>
---

diff --git a/Documentation/blame-options.txt b/Documentation/blame-options.txt
index 331f161c7..a46bf6ce7 100644
--- a/Documentation/blame-options.txt
+++ b/Documentation/blame-options.txt
@@ -9,8 +9,28 @@
 --show-stats::
 	Include additional statistics at the end of blame output.
 
--L n,m::
-	Annotate only the specified line range (lines count from 1).
+-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
++
+This is only valid for <end> and will specify a number
+of lines before or after the line given by <start>.
++
 
 -l::
 	Show long rev (Default: off).