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

[PATCH] docs/git-blame: explain carets on boundary commits

From
SKStephen Kitt <steve@sk2.org>
Date
Jun 8, 2018, 19:31 UTC
Message-ID
<20180608193135.31110-1-steve@sk2.org>

The caret on boundary commits is only mentioned in the description of --abbrev; this patch adds a description of the behaviour in the paragraph describing how revision range specifiers are handled.

Signed-off-by: Stephen Kitt <steve@sk2.org>
---
 Documentation/git-blame.txt | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/Documentation/git-blame.txt b/Documentation/git-blame.txt
index 16323eb80..7f814dcef 100644
--- a/Documentation/git-blame.txt
+++ b/Documentation/git-blame.txt
@@ -163,7 +163,8 @@ When revision range specifiers are used to limit the annotation,
 lines that have not changed since the range boundary (either the
 commit v2.6.18 or the most recent commit that is more than 3
 weeks old in the above example) are blamed for that range
-boundary commit.
+boundary commit.  The sha1 is preceded by a caret, '^' to indicate
+this (and its length is reduced by 1).
 
 A particularly useful way is to see if an added file has lines
 created by copy-and-paste from existing files.  Sometimes this
-- 
2.11.0
Message 1 of 1 in “docs/git-blame: explain carets on boundary commits”
  1. docs/git-blame: explain carets on boundary commitsStephen Kitt, Jun 8, 2018

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.