git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH 5/8] Update -L documentation for git-blame/git-annotate

From
Andrew Ruder <andy@aeruder.net>
Date
Apr 27, 2007, 05:09 UTC
Message-ID
<20070427050949.GD9798@bowser.ruder>
In-Reply-To
<20070427050550.GA9594@bowser.ruder>
Documenting alternate ways to use -L:

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

Signed-off-by: Andrew Ruder <andy@aeruder.net>
---
 Documentation/blame-options.txt |   24 ++++++++++++++++++++++--
 1 files changed, 22 insertions(+), 2 deletions(-)
diff --git a/Documentation/blame-options.txt b/Documentation/blame-options.txt
index 331f161..0099bb2 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).
-- 
1.5.2.rc0.64.g8476
Previous: Andrew RuderNext: Andrew Ruder
Message 5 of 10 in “Removing -n option from git-diff-files documentation”
  1. 1/8 Removing -n option from git-diff-files documentationAndrew Ruder, Apr 27, 2007
  2. 2/8 Document additional options for git-fetchAndrew Ruder, Apr 27, 2007
  3. 3/8 Update git-fmt-merge documentationAndrew Ruder, Apr 27, 2007
  4. 4/8 Update git-grep documentationAndrew Ruder, Apr 27, 2007
  5. 5/8 Update -L documentation for git-blame/git-annotateAndrew Ruder, Apr 27, 2007
  6. 6/8 Update git-http-push documentationAndrew Ruder, Apr 27, 2007
  7. 7/8 Update git-local-fetch documentationAndrew Ruder, Apr 27, 2007
  8. 8/8 Update git-http-fetch documentationAndrew Ruder, Apr 27, 2007
  9. Petr BaudisApr 27, 2007
  10. Junio C HamanoApr 29, 2007

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.