Skip to content

Commit e5dce96

Browse files
committed
git blame: document that it always follows origin across whole-file renames
Make it clear to people who (rightly or wrongly) think that the "--follow" option should follow origin across while-file renames that we already do so. That would explain the output that they see when they do give the "--follow" option to the command. We may or may not want to do a "--no-follow" patch as a follow-up, but that is a separate topic. Signed-off-by: Junio C Hamano <[email protected]>
1 parent bafc478 commit e5dce96

File tree

1 file changed

+6
-0
lines changed

1 file changed

+6
-0
lines changed

Documentation/git-blame.txt

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,12 @@ last modified the line. Optionally, start annotating from the given revision.
2020

2121
The command can also limit the range of lines annotated.
2222

23+
The origin of lines is automatically followed across whole-file
24+
renames (currently there is no option to turn the rename-following
25+
off). To follow lines moved from one file to another, or to follow
26+
lines that were copied and pasted from another file, etc., see the
27+
`-C` and `-M` options.
28+
2329
The report does not tell you anything about lines which have been deleted or
2430
replaced; you need to use a tool such as 'git diff' or the "pickaxe"
2531
interface briefly mentioned in the following paragraph.

0 commit comments

Comments
 (0)