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

[PATCH/RFC] Documentation/git-mailsplit.txt: Emphasize -o more

From
jidanni@jidanni.org <jidanni@jidanni.org>
Date
Jan 12, 2009, 21:28 UTC
Message-ID
<877i50jjs8.fsf@jidanni.org>

The need for -o cannot be overstated. Else the arguments get interpreted differently. We also mention the output. (By the way, "fatal: unknown option: -o" is seen if a space comes after it.)

Signed-off-by: jidanni <jidanni@jidanni.org>
---
 Documentation/git-mailsplit.txt |   11 ++++++++---
 1 files changed, 8 insertions(+), 3 deletions(-)
diff --git a/Documentation/git-mailsplit.txt b/Documentation/git-mailsplit.txt
index 5cc94ec..5dc24c9 100644
--- a/Documentation/git-mailsplit.txt
+++ b/Documentation/git-mailsplit.txt
@@ -13,10 +13,18 @@ DESCRIPTION
 -----------
 Splits a mbox file or a Maildir into a list of files: "0001" "0002" ..  in the
 specified directory so you can process them further from there.
+The number of files produced is printed to the standard output.
 
 IMPORTANT: Maildir splitting relies upon filenames being sorted to output
 patches in the correct order.
 
+REQUIRED OPTIONS
+-------
+-o<directory>::
+	Directory in which to place the individual messages.
+	-o is required or else arguments may be misinterpreted in a
+	backwards compatibility mode.
+
 OPTIONS
 -------
 <mbox>::
@@ -27,9 +35,6 @@ OPTIONS
 	Root of the Maildir to split. This directory should contain the cur, tmp
 	and new subdirectories.
 
--o<directory>::
-	Directory in which to place the individual messages.
-
 -b::
 	If any file doesn't begin with a From line, assume it is a
 	single mail message instead of signaling error.
-- 
1.6.0.6
Next: Junio C Hamano
Message 1 of 3 in “Documentation/git-mailsplit.txt: Emphasize -o more”
  1. Documentation/git-mailsplit.txt: Emphasize -o morejidanni@jidanni.org, Jan 12, 2009
  2. Junio C HamanoJan 12, 2009
  3. jidanni@jidanni.orgJan 12, 2009

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.