git hyper-blame: Added approx. line number translation.
Previously, when a commit was skipped, it would be blamed on the line
number the line had *after* the skipped commit. This could mean a
totally unrelated commit gets blamed. Now, a heuristic analyses the diff
of the skipped commit to discover approximately what line number the
line had *before* the skipped commit, so it can hopefully be blamed on
the right commit.
BUG=574290
Review URL: https://codereview.chromium.org/1629253002
git-svn-id: svn://svn.chromium.org/chrome/trunk/tools/depot_tools@298609 0039d316-1c4b-4281-b951-d872f2087c98
diff --git a/man/html/git-hyper-blame.html b/man/html/git-hyper-blame.html
index a08de12..62f7cc8 100644
--- a/man/html/git-hyper-blame.html
+++ b/man/html/git-hyper-blame.html
@@ -820,19 +820,24 @@
</div>
</div>
<div class="sect1">
+<h2 id="_caveats">CAVEATS</h2>
+<div class="sectionbody">
+<div class="paragraph"><p>When a line skips over an ignored commit, a guess is made as to which commit
+previously modified that line, but it is not always clear where the line came
+from. If the ignored commit makes lots of changes in close proximity, in
+particular adding/removing/reordering lines, then the wrong authors may be
+blamed for nearby edits.</p></div>
+<div class="paragraph"><p>For this reason, <code>hyper-blame</code> works best when the ignored commits are be
+limited to minor changes such as formatting and renaming, not refactoring or
+other more invasive changes.</p></div>
+</div>
+</div>
+<div class="sect1">
<h2 id="_bugs">BUGS</h2>
<div class="sectionbody">
<div class="ulist"><ul>
<li>
<p>
-When a commit is ignored, hyper-blame currently just blames the same line in
- the previous version of the file. This can be wildly inaccurate if the ignored
- commit adds or removes lines, resulting in a completely wrong commit being
- blamed.
-</p>
-</li>
-<li>
-<p>
There is currently no way to pass the ignore list as a file.
</p>
</li>
@@ -864,7 +869,7 @@
<div id="footnotes"><hr /></div>
<div id="footer">
<div id="footer-text">
-Last updated 2016-01-28 16:40:21 AEDT
+Last updated 2016-02-05 13:43:52 AEDT
</div>
</div>
</body>