diff options
author | Junio C Hamano <gitster@pobox.com> | 2013-09-09 15:35:20 -0700 |
---|---|---|
committer | Junio C Hamano <gitster@pobox.com> | 2013-09-09 15:35:20 -0700 |
commit | 8eac268d5824abada1efa8990ea211f476ca942b (patch) | |
tree | 712e2b7c4f6bcacc8bacfed4d7ee98ed8aa484ce /git-blame.html | |
parent | 91e3395c6964b309b071bf9fe79bd004c979b297 (diff) | |
download | git-htmldocs-8eac268d5824abada1efa8990ea211f476ca942b.tar.gz |
Autogenerated HTML docs for v1.8.4-242-gbb80ee
Diffstat (limited to 'git-blame.html')
-rw-r--r-- | git-blame.html | 36 |
1 files changed, 20 insertions, 16 deletions
diff --git a/git-blame.html b/git-blame.html index 4e23ee2f0..e8a9c2376 100644 --- a/git-blame.html +++ b/git-blame.html @@ -747,7 +747,7 @@ git-blame(1) Manual Page <div class="sectionbody">
<div class="verseblock">
<pre class="content"><em>git blame</em> [-c] [-b] [-l] [--root] [-t] [-f] [-n] [-s] [-e] [-p] [-w] [--incremental]
- [-L n,m | -L :fn] [-S <revs-file>] [-M] [-C] [-C] [-C] [--since=<date>]
+ [-L <range>] [-S <revs-file>] [-M] [-C] [-C] [-C] [--since=<date>]
[--abbrev=<n>] [<rev> | --contents <file> | --reverse <rev>] [--] <file></pre>
<div class="attribution">
</div></div>
@@ -758,7 +758,8 @@ git-blame(1) Manual Page <div class="sectionbody">
<div class="paragraph"><p>Annotates each line in the given file with information from the revision which
last modified the line. Optionally, start annotating from the given revision.</p></div>
-<div class="paragraph"><p>The command can also limit the range of lines annotated.</p></div>
+<div class="paragraph"><p>When specified one or more times, <code>-L</code> restricts annotation to the requested
+lines.</p></div>
<div class="paragraph"><p>The origin of lines is automatically followed across whole-file
renames (currently there is no option to turn the rename-following
off). To follow lines moved from one file to another, or to follow
@@ -818,10 +819,11 @@ ea4c7f9bf69e781dd0cd88d2bccb2bf5cc15c9a7 git-blame: Make the output</code></pre> </dt>
<dd>
<p>
- Annotate only the given line range. <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>.
+ Annotate only the given line range. May be specified multiple times.
+ Overlapping ranges are allowed.
</p>
+<div class="paragraph"><p><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>.</p></div>
<div class="paragraph"><p><start> and <end> can take one of these forms:</p></div>
<div class="ulist"><ul>
<li>
@@ -836,7 +838,10 @@ absolute line number (lines count from 1).</p></div> /regex/
</p>
<div class="paragraph"><p>This form will use the first line matching the given
-POSIX regex. If <end> is a regex, it will search
+POSIX regex. If <start> is a regex, it will search from the end of
+the previous <code>-L</code> range, if any, otherwise from the start of file.
+If <start> is “^/regex/”, it will search from the start of file.
+If <end> is a regex, it will search
starting at the line given by <start>.</p></div>
</li>
<li>
@@ -846,15 +851,12 @@ starting at the line given by <start>.</p></div> <div class="paragraph"><p>This is only valid for <end> and will specify a number
of lines before or after the line given by <start>.</p></div>
</li>
-<li>
-<p>
-:regex
-</p>
-<div class="paragraph"><p>If the option’s argument is of the form :regex, it denotes the range
-from the first funcname line that matches <regex>, up to the next
-funcname line.</p></div>
-</li>
</ul></div>
+<div class="paragraph"><p>If “:<regex>” is given in place of <start> and <end>, it denotes the range
+from the first funcname line that matches <regex>, up to the next
+funcname line. “:<regex>” searches from the end of the previous <code>-L</code> range,
+if any, otherwise from the start of file.
+“^:<regex>” searches from the start of file.</p></div>
</dd>
<dt class="hdlist1">
-l
@@ -1169,7 +1171,9 @@ sort | uniq -c | sort -rn</code></pre> <div class="sectionbody">
<div class="paragraph"><p>Unlike <em>git blame</em> and <em>git annotate</em> in older versions of git, the extent
of the annotation can be limited to both line ranges and revision
-ranges. When you are interested in finding the origin for
+ranges. The <code>-L</code> option, which limits annotation to a range of lines, may be
+specified multiple times.</p></div>
+<div class="paragraph"><p>When you are interested in finding the origin for
lines 40-60 for file <code>foo</code>, you can use the <code>-L</code> option like so
(they mean the same thing — both ask for 21 lines starting at
line 40):</p></div>
@@ -1377,7 +1381,7 @@ the email address.</p></div> <div id="footnotes"><hr /></div>
<div id="footer">
<div id="footer-text">
-Last updated 2013-08-20 08:40:27 PDT
+Last updated 2013-09-09 15:34:20 PDT
</div>
</div>
</body>
|