[notmuch] [PATCH 2/2] document new `notmuch new` behavior

diff --git a/5f/e12d2ee9adfdce28903e0fb1b0f7d04f62f1c7 b/5f/e12d2ee9adfdce28903e0fb1b0f7d04f62f1c7
new file mode 100644 (file)
index 0000000..b500abf
--- /dev/null
+++ b/5f/e12d2ee9adfdce28903e0fb1b0f7d04f62f1c7
@@ -0,0 +1,88 @@
+Return-Path: <pioto@pioto.org>\r
+X-Original-To: notmuch@notmuchmail.org\r
+Delivered-To: notmuch@notmuchmail.org\r
+Received: from localhost (localhost [127.0.0.1])\r
+       by olra.theworths.org (Postfix) with ESMTP id 9954A431FC4\r
+       for <notmuch@notmuchmail.org>; Fri, 26 Feb 2010 11:49:15 -0800 (PST)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: -0.846\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=-0.846 tagged_above=-999 required=5\r
+       tests=[AWL=-0.661, BAYES_40=-0.185] autolearn=ham\r
+Received: from olra.theworths.org ([127.0.0.1])\r
+       by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
+       with ESMTP id z5pu1xu6JLCX for <notmuch@notmuchmail.org>;\r
+       Fri, 26 Feb 2010 11:49:15 -0800 (PST)\r
+Received: from everglades.pioto.org (everglades.pioto.org [207.192.69.249])\r
+       by olra.theworths.org (Postfix) with ESMTP id 09933431FAE\r
+       for <notmuch@notmuchmail.org>; Fri, 26 Feb 2010 11:49:15 -0800 (PST)\r
+Received: from aether.pioto.org (pool-96-236-149-110.pitbpa.fios.verizon.net\r
+       [96.236.149.110]) (Authenticated sender: pioto)\r
+       by everglades.pioto.org (Postfix) with ESMTPA id 2F9B41603FC;\r
+       Fri, 26 Feb 2010 14:49:09 -0500 (EST)\r
+Received: by aether.pioto.org (Postfix, from userid 1000)\r
+       id B3EFE60344; Fri, 26 Feb 2010 14:50:01 -0500 (EST)\r
+From: Mike Kelly <pioto@pioto.org>\r
+To: notmuch@notmuchmail.org\r
+Date: Fri, 26 Feb 2010 14:49:27 -0500\r
+Message-Id: <1267213767-31255-3-git-send-email-pioto@pioto.org>\r
+X-Mailer: git-send-email 1.7.0\r
+In-Reply-To: <1267213767-31255-1-git-send-email-pioto@pioto.org>\r
+References: <1267213767-31255-1-git-send-email-pioto@pioto.org>\r
+Subject: [notmuch] [PATCH 2/2] document new `notmuch new` behavior\r
+X-BeenThere: notmuch@notmuchmail.org\r
+X-Mailman-Version: 2.1.13\r
+Precedence: list\r
+List-Id: "Use and development of the notmuch mail system."\r
+       <notmuch.notmuchmail.org>\r
+List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
+       <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
+List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
+List-Post: <mailto:notmuch@notmuchmail.org>\r
+List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
+List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
+       <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
+X-List-Received-Date: Fri, 26 Feb 2010 19:49:15 -0000\r
+\r
+---\r
+ notmuch.1 |    8 +++++---\r
+ notmuch.c |    3 ++-\r
+ 2 files changed, 7 insertions(+), 4 deletions(-)\r
+\r
+diff --git a/notmuch.1 b/notmuch.1\r
+index 282ad98..f03529e 100644\r
+--- a/notmuch.1\r
++++ b/notmuch.1\r
+@@ -93,9 +93,11 @@ The\r
+ .B new\r
+ command scans all sub-directories of the database, performing\r
+ full-text indexing on new messages that are found. Each new message\r
+-will automatically be tagged with both the\r
+-.BR inbox " and " unread\r
+-tags.\r
++will automatically be tagged with the\r
++.BR inbox\r
++tag, and, unless it was already "seen" by another client, the\r
++.BR unread\r
++tag.\r
+ \r
+ You should run\r
+ .B "notmuch new"\r
+diff --git a/notmuch.c b/notmuch.c\r
+index 87479f8..fc6bb7f 100644\r
+--- a/notmuch.c\r
++++ b/notmuch.c\r
+@@ -127,7 +127,8 @@ command_t commands[] = {\r
+       "\t\tFind and import new messages to the notmuch database.",\r
+       "\t\tScans all sub-directories of the mail directory, performing\n"\r
+       "\t\tfull-text indexing on new messages that are found. Each new\n"\r
+-      "\t\tmessage will be tagged as both \"inbox\" and \"unread\".\n"\r
++      "\t\tmessage will be tagged as \"inbox\" and, unless it is\n"\r
++      "\t\tmarked as \"seen\", \"unread\".\n"\r
+       "\n"\r
+       "\t\tYou should run \"notmuch new\" once after first running\n"\r
+       "\t\t\"notmuch setup\" to create the initial database. The first\n"\r
+-- \r
+1.7.0\r
+\r