From: Jani Nikula Date: Mon, 10 Jun 2013 16:28:34 +0000 (+0300) Subject: [PATCH v3] man: document notmuch search --duplicate=N X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=7b656b4280c76802b7e6fe2dbcc1939112bfa2e1;p=notmuch-archives.git [PATCH v3] man: document notmuch search --duplicate=N --- diff --git a/9b/290c9c7ffc9f37797d2ea1d4705d97c2782f9a b/9b/290c9c7ffc9f37797d2ea1d4705d97c2782f9a new file mode 100644 index 000000000..b8df9423f --- /dev/null +++ b/9b/290c9c7ffc9f37797d2ea1d4705d97c2782f9a @@ -0,0 +1,117 @@ +Return-Path: +X-Original-To: notmuch@notmuchmail.org +Delivered-To: notmuch@notmuchmail.org +Received: from localhost (localhost [127.0.0.1]) + by olra.theworths.org (Postfix) with ESMTP id D2FF3431FC4 + for ; Mon, 10 Jun 2013 09:28:49 -0700 (PDT) +X-Virus-Scanned: Debian amavisd-new at olra.theworths.org +X-Spam-Flag: NO +X-Spam-Score: -0.7 +X-Spam-Level: +X-Spam-Status: No, score=-0.7 tagged_above=-999 required=5 + tests=[RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled +Received: from olra.theworths.org ([127.0.0.1]) + by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024) + with ESMTP id l1kifQY9g5y1 for ; + Mon, 10 Jun 2013 09:28:42 -0700 (PDT) +Received: from mail-lb0-f178.google.com (mail-lb0-f178.google.com + [209.85.217.178]) (using TLSv1 with cipher RC4-SHA (128/128 bits)) + (No client certificate requested) + by olra.theworths.org (Postfix) with ESMTPS id 197B9431FB6 + for ; Mon, 10 Jun 2013 09:28:41 -0700 (PDT) +Received: by mail-lb0-f178.google.com with SMTP id y6so5024943lbh.9 + for ; Mon, 10 Jun 2013 09:28:40 -0700 (PDT) +X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; + d=google.com; s=20120113; + h=from:to:cc:subject:date:message-id:x-mailer:in-reply-to:references + :x-gm-message-state; + bh=R9kPXSyS7hq59WrlCm1YhNzYFza7FFoweiEEWLL4uC4=; + b=Va9jm5eienQLPjf6tJsRq8GsjwB3MaoSo7L9zfe4U5gFXgdB36WqdD9f8BBYlPSNuX + PWMmQhgO6e41TqLBR+8fhdgCXxccDVWTWzOzmQWNZi4Dt/r0mG6ZXvJ+LNEv5XJusIEy + VX/IBjvt66ptUjl4UcjeFS/Czjgr+8HO/FvL/D2K4xnac6KNg9Dc1vf3N1W5fXyxaV4s + bDQtKDusI69JTLfG4O2daJaf3rmqB06ueGQfwtOgaUD9r8Pj/pJAzl9Dus5W8HWhkJOA + +RlkIPjQ4Df8N/4gPIVN9M134RVE0OhABmAWTR5sMWWjyf3EYfdMR8MOvlFwJeUVhXJO + 2OUQ== +X-Received: by 10.152.116.7 with SMTP id js7mr5336485lab.7.1370881720639; + Mon, 10 Jun 2013 09:28:40 -0700 (PDT) +Received: from localhost (dsl-hkibrasgw2-58c376-211.dhcp.inet.fi. + [88.195.118.211]) + by mx.google.com with ESMTPSA id a3sm5958543lbg.2.2013.06.10.09.28.38 + for + (version=TLSv1.2 cipher=RC4-SHA bits=128/128); + Mon, 10 Jun 2013 09:28:39 -0700 (PDT) +From: Jani Nikula +To: notmuch@notmuchmail.org, + Mark Walters +Subject: [PATCH v3] man: document notmuch search --duplicate=N +Date: Mon, 10 Jun 2013 19:28:34 +0300 +Message-Id: <1370881714-3303-1-git-send-email-jani@nikula.org> +X-Mailer: git-send-email 1.7.10.4 +In-Reply-To: + +References: + +X-Gm-Message-State: + ALoCoQkF7piGjokuuuPLA3cKNT3QqwfvDtpfPXS4NcMqm0zbSaE3f0SQ5OSzpC9SCkUc1BIB4bIt +X-BeenThere: notmuch@notmuchmail.org +X-Mailman-Version: 2.1.13 +Precedence: list +List-Id: "Use and development of the notmuch mail system." + +List-Unsubscribe: , + +List-Archive: +List-Post: +List-Help: +List-Subscribe: , + +X-List-Received-Date: Mon, 10 Jun 2013 16:28:50 -0000 + +--- + +v3: clarify dupe vs. folder prefix per Mark's suggestion +--- + man/man1/notmuch-search.1 | 20 ++++++++++++++++++++ + 1 file changed, 20 insertions(+) + +diff --git a/man/man1/notmuch-search.1 b/man/man1/notmuch-search.1 +index 1c1e049..957b24b 100644 +--- a/man/man1/notmuch-search.1 ++++ b/man/man1/notmuch-search.1 +@@ -80,6 +80,10 @@ Output the filenames of all messages matching the search terms, either + one per line (\-\-format=text), separated by null characters + (\-\-format=text0), as a JSON array (\-\-format=json), or as an + S-Expression list (\-\-format=sexp). ++ ++Note that each message may have multiple filenames associated with it. ++All of them are included in the output, unless limited with the ++\-\-duplicate=N option. + .RE + .RS 4 + .TP 4 +@@ -158,6 +162,22 @@ but the "match count" is the number of matching non-excluded messages in the + thread, rather than the number of matching messages. + .RE + ++.RS 4 ++.TP 4 ++.BR \-\-duplicate=N ++ ++Effective with ++.BR --output=files , ++output the Nth filename associated with each message matching the ++query (N is 1-based). If N is greater than the number of files ++associated with the message, don't print anything. ++ ++Note that this option is orthogonal with the ++.BR folder: ++search prefix. The prefix matches messages based on filenames. This ++option filters filenames of the matching messages. ++.RE ++ + .SH EXIT STATUS + + This command supports the following special exit status codes +-- +1.7.10.4 +