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

[PATCH v2] Doc: specify exact scissors line

From
Evan Gates <evan.gates@gmail.com>
Date
Sep 28, 2020, 20:20 UTC
Message-ID
<20200928202035.24218-1-evan.gates@gmail.com>
In-Reply-To
<20200925191659.31375-1-evan.gates@gmail.com>

The existing wording covers most of the requirements of a scissors line, but there is no mention of the minimum size requirement that led to a six character line ("-->8--") not counting as a scissors line. Specify the exact line to use ("-- >8 --") instead of trying to document all the details.

Signed-off-by: Evan Gates <evan.gates@gmail.com>
---
Changes in v2:
- Specify exact line instead of adding text about 8 character minimum
 Documentation/git-mailinfo.txt | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)
diff --git a/Documentation/git-mailinfo.txt b/Documentation/git-mailinfo.txt
index 3bbc731f67..fbb7d2813f 100644
--- a/Documentation/git-mailinfo.txt
+++ b/Documentation/git-mailinfo.txt
@@ -72,10 +72,9 @@ conversion, even with this flag.
 	is useful in order to associate commits with mailing list discussions.
 
 --scissors::
-	Remove everything in body before a scissors line.  A line that
-	mainly consists of scissors (either ">8" or "8<") and perforation
-	(dash "-") marks is called a scissors line, and is used to request
-	the reader to cut the message at that line.  If such a line
+	Remove everything in body before a scissors line ("-- >8 --").
+	The line represents scissors and perforation marks, and is used to
+	request the reader to cut the message at that line.  If that line
 	appears in the body of the message before the patch, everything
 	before it (including the scissors line itself) is ignored when
 	this option is used.
-- 
2.28.0
Previous: Kevin DaudtNext: Evan Gates
Message 7 of 10 in “Doc: note minimum scissors line length for mailinfo”
  1. Doc: note minimum scissors line length for mailinfoEvan Gates, Sep 25, 2020
  2. jrnieder@gmail.comSep 28, 2020
  3. Junio C HamanoSep 28, 2020
  4. Jonathan NiederSep 28, 2020
  5. Evan GatesSep 28, 2020
  6. Kevin DaudtSep 28, 2020
  7. Doc: specify exact scissors lineEvan Gates, Sep 28, 2020
  8. Doc: show example scissors lineEvan Gates, Sep 28, 2020
  9. Junio C HamanoSep 28, 2020
  10. Junio C HamanoSep 28, 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.