From 0bbef99944059d992c6a0feaacb8cbeffd19baa6 Mon Sep 17 00:00:00 2001 From: Jani Nikula Date: Sat, 17 Aug 2013 15:11:28 +0300 Subject: [PATCH] [PATCH v3 3/8] man: document notmuch search --duplicate=N --- 69/a9d5e3b7cdb14571720321b9417cbd02e5b57f | 119 ++++++++++++++++++++++ 1 file changed, 119 insertions(+) create mode 100644 69/a9d5e3b7cdb14571720321b9417cbd02e5b57f diff --git a/69/a9d5e3b7cdb14571720321b9417cbd02e5b57f b/69/a9d5e3b7cdb14571720321b9417cbd02e5b57f new file mode 100644 index 000000000..a2e022c3d --- /dev/null +++ b/69/a9d5e3b7cdb14571720321b9417cbd02e5b57f @@ -0,0 +1,119 @@ +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 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 + -- 2.26.2