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

[PATCH 1/1] MyFirstContribution: configure shallow threads for git format-patch

From
Stan Hu <stanhu@gmail.com>
Date
Dec 7, 2023, 05:46 UTC
Message-ID
<e197cbd28135df5523ff5ba1688566edb831f037.1701927372.git.stanhu@gmail.com>
In-Reply-To
<cover.1701927372.git.stanhu@gmail.com>

Most users on the Git mailing list prefers to use of shallow threads, but this preference was not documented. This commit adds a blurb about how to configure this globally via `git config`.

Signed-off-by: Stan Hu <stanhu@gmail.com>
---
 Documentation/MyFirstContribution.txt | 11 +++++++++++
 1 file changed, 11 insertions(+)
diff --git a/Documentation/MyFirstContribution.txt b/Documentation/MyFirstContribution.txt
index 7cfed60c2e..3ac7455b1d 100644
--- a/Documentation/MyFirstContribution.txt
+++ b/Documentation/MyFirstContribution.txt
@@ -1004,6 +1004,17 @@ determine the right way to configure it to use your SMTP server; again, as this
 configuration can change significantly based on your system and email setup, it
 is out of scope for the context of this tutorial.
 
+[[configure-shallow-threads]]
+=== Configuring shallow threads for `git format-patch`
+
+It is common practice on the Git mailing list to use "shallow" threads,
+where every mail is a reply to the first mail of the series. You can
+configure the default threading style of `git format-patch` via:
+
+-----
+$ git config format.thread shallow
+----
+
 [[format-patch]]
 === Preparing Initial Patchset
 
-- 
2.42.0
Next: Junio C Hamano
Message 1 of 2 in “MyFirstContribution: configure shallow threads for git format-patch”
  1. 1/1 MyFirstContribution: configure shallow threads for git format-patchStan Hu, Dec 7, 2023
  2. Junio C HamanoDec 8, 2023

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.