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

[PATCH] blame-options.txt: document --first-parent option

From
Raymond E. Pasco <ray@ameretat.dev>
Date
Aug 6, 2020, 18:52 UTC
Message-ID
<20200806185243.27179-1-ray@ameretat.dev>
In-Reply-To
<xmqq1rkjljus.fsf@gitster.c.googlers.com>

blame/annotate have supported --first-parent since commit 95a4fb0eac ("blame: handle --first-parent"). This adds a blurb on that option to the documentation.

Signed-off-by: Raymond E. Pasco <ray@ameretat.dev>
---
 Documentation/blame-options.txt | 6 ++++++
 1 file changed, 6 insertions(+)
diff --git a/Documentation/blame-options.txt b/Documentation/blame-options.txt
index 5d122db6e9..88750af7ae 100644
--- a/Documentation/blame-options.txt
+++ b/Documentation/blame-options.txt
@@ -36,6 +36,12 @@ include::line-range-format.txt[]
 	START.  `git blame --reverse START` is taken as `git blame
 	--reverse START..HEAD` for convenience.
 
+--first-parent::
+	Follow only the first parent commit upon seeing a merge
+	commit. This option can be used to determine when a line
+	was introduced to a particular integration branch, rather
+	than when it was introduced to the history overall.
+
 -p::
 --porcelain::
 	Show in a format designed for machine consumption.
-- 
2.28.0
Previous: Junio C HamanoNext: Jeff King
Message 7 of 10 in “Why is AuthorDate displayed on git-blame?”
  1. נעם סולוביצ'יקAug 5, 2020
  2. Junio C HamanoAug 5, 2020
  3. Raymond E. PascoAug 6, 2020
  4. Noam SoloveichikAug 6, 2020
  5. Raymond E. PascoAug 6, 2020
  6. Junio C HamanoAug 6, 2020
  7. blame-options.txt: document --first-parent optionRaymond E. Pasco, Aug 6, 2020
  8. Jeff KingAug 8, 2020
  9. brian m. carlsonAug 5, 2020
  10. Junio C HamanoAug 5, 2020

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.