From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from localhost (localhost [127.0.0.1]) by olra.theworths.org (Postfix) with ESMTP id 9B61D421171 for ; Sat, 17 Aug 2013 05:11:54 -0700 (PDT) X-Virus-Scanned: Debian amavisd-new at olra.theworths.org X-Amavis-Alert: BAD HEADER SECTION, Duplicate header field: "References" 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 hkkCL3mSKfkL for ; Sat, 17 Aug 2013 05:11:50 -0700 (PDT) Received: from mail-bk0-f53.google.com (mail-bk0-f53.google.com [209.85.214.53]) (using TLSv1 with cipher RC4-SHA (128/128 bits)) (No client certificate requested) by olra.theworths.org (Postfix) with ESMTPS id 4ABD5429E4A for ; Sat, 17 Aug 2013 05:11:41 -0700 (PDT) Received: by mail-bk0-f53.google.com with SMTP id d7so913662bkh.26 for ; Sat, 17 Aug 2013 05:11:40 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20120113; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:in-reply-to:references; bh=sB51YMdzTimwYDfK+LkstuirW5oZMIeZ0qLaPCLa+Ec=; b=aZSaatEwUvOajwP176dTZ7EjvmaHEWHBZngVr0rgjfCdU20BsCN8JZH4zucpjQGDKQ SwIP7VOosZ/ACzTm729Uuk5hsGdydTpMlR3DQde4EHCYbgu/qyUiEbFPk3lT3trVCCfV x9ektlf5YbWGOiPIYhfM+I5CZa0EhqZ9ZTxl60K/3S+Lp216NAlBYsN7nJFqaM6bZcf6 loOXT/Bxtz1P+799fwA8G/0wr5sPR0fkzi/UK1HqOM02xFoYAFg059S48UTzD6iOfYTF tbOa/Se8jmZAulMX7RXP/k9wD1NxY240n8HdXklfjaMaSA8O1AewGThonXB6VSlPPdxn nmLQ== X-Gm-Message-State: ALoCoQn1OwLHo4GbJozm8CO4U2CYOVchrhhwnGxkFBC0ch9sVKaZugcGpUTn/u3s2VL2Z3BbXuQK X-Received: by 10.205.9.198 with SMTP id ox6mr1661198bkb.19.1376741499997; Sat, 17 Aug 2013 05:11:39 -0700 (PDT) Received: from localhost (dsl-hkibrasgw2-58c36f-91.dhcp.inet.fi. [88.195.111.91]) by mx.google.com with ESMTPSA id if11sm249815bkc.15.1969.12.31.16.00.00 (version=TLSv1.2 cipher=RC4-SHA bits=128/128); Sat, 17 Aug 2013 05:11:38 -0700 (PDT) From: Jani Nikula To: notmuch@notmuchmail.org Subject: [PATCH v3 3/8] man: document notmuch search --duplicate=N Date: Sat, 17 Aug 2013 15:11:28 +0300 Message-Id: X-Mailer: git-send-email 1.7.10.4 In-Reply-To: References: In-Reply-To: References: 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: Sat, 17 Aug 2013 12:11:55 -0000 Document the notmuch search --duplicate=N option. --- 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 2d6ecaf..f69a4cd 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