From 5e167e4619d1f4a4e77655ac804760504af94910 Mon Sep 17 00:00:00 2001 From: Jani Nikula Date: Sun, 1 Apr 2012 01:17:28 +0300 Subject: [PATCH] [PATCH 8/8] man: document notmuch tag --stdin option --- c7/758a4ee026c9bb128f8a58d1a237c01c75164c | 137 ++++++++++++++++++++++ 1 file changed, 137 insertions(+) create mode 100644 c7/758a4ee026c9bb128f8a58d1a237c01c75164c diff --git a/c7/758a4ee026c9bb128f8a58d1a237c01c75164c b/c7/758a4ee026c9bb128f8a58d1a237c01c75164c new file mode 100644 index 000000000..2da117e23 --- /dev/null +++ b/c7/758a4ee026c9bb128f8a58d1a237c01c75164c @@ -0,0 +1,137 @@ +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 676F1431FAF + for ; Sat, 31 Mar 2012 15:18:14 -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 jk1Me5zuRvVN for ; + Sat, 31 Mar 2012 15:18:13 -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 7EEB642116D + for ; Sat, 31 Mar 2012 15:18:04 -0700 (PDT) +Received: by mail-bk0-f53.google.com with SMTP id j4so1547751bkw.26 + for ; Sat, 31 Mar 2012 15:18:04 -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 + :in-reply-to:references:x-gm-message-state; + bh=FT5S5LjPivguigI6i9a0sHE9gaModZ1raAl9XQanz1M=; + b=BKtChfbn2JxpKQK21H/lZEfU+rQ7/q3PqD8nldjOtMcK3+dogpeBAYvWha8JzIiqOr + L8e/X8g8hir8QGwkX/rX8BxuEQ8KWRA46fv1+kZHg+bwqAoiS57qyKeMHiTKhlkEaBK1 + 57OO0WU8skpNwgtlOF3S/co7ML+sHoronqXeHhOUCsoeoL6qreuJ+oebJtczcz1RyLYx + QeiPqdpEFqEcsn9CNfqu6gDyCBMuIaPrzj9L8FF32RZfr0QVKCUph1VOMhnXxA5djRwz + e9MjKLlEC+c741ONPGTI7dUuf53VGUAI/YpwoHFCVdnNjY6AsVl5TWdg028VL1Uvcg0P + 3V7Q== +Received: by 10.204.151.89 with SMTP id b25mr1344375bkw.18.1333232284072; + Sat, 31 Mar 2012 15:18:04 -0700 (PDT) +Received: from localhost (dsl-hkibrasgw4-fe50f800-253.dhcp.inet.fi. + [84.248.80.253]) + by mx.google.com with ESMTPS id cy11sm2639212bkb.7.2012.03.31.15.18.02 + (version=SSLv3 cipher=OTHER); Sat, 31 Mar 2012 15:18:03 -0700 (PDT) +From: Jani Nikula +To: notmuch@notmuchmail.org +Subject: [PATCH 8/8] man: document notmuch tag --stdin option +Date: Sun, 1 Apr 2012 01:17:28 +0300 +Message-Id: + +X-Mailer: git-send-email 1.7.5.4 +In-Reply-To: +References: +In-Reply-To: +References: +X-Gm-Message-State: + ALoCoQkp4VRj1dH/S+zgxG8G9MlIzzlj7tTWXPhdLITveh6EdxhTilHElQXhAt1zNZXwCPZ1Wp3K +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, 31 Mar 2012 22:18:14 -0000 + +--- + man/man1/notmuch-tag.1 | 44 +++++++++++++++++++++++++++++++++++++++++++- + 1 files changed, 43 insertions(+), 1 deletions(-) + +diff --git a/man/man1/notmuch-tag.1 b/man/man1/notmuch-tag.1 +index aa4546e..30693cf 100644 +--- a/man/man1/notmuch-tag.1 ++++ b/man/man1/notmuch-tag.1 +@@ -4,7 +4,11 @@ notmuch-tag \- Add/remove tags for all messages matching the search terms. + + .SH SYNOPSIS + .B notmuch tag +-.RI "+<" tag> "|\-<" tag "> [...] [\-\-] <" search-term ">..." ++.RI "+<" tag ">|\-<" tag "> [...] [\-\-] <" search-terms ">" ++ ++.B notmuch tag ++.RI "--stdin" ++ + + .SH DESCRIPTION + +@@ -29,6 +33,44 @@ updates the maildir flags according to tag changes if the + configuration option is enabled. See \fBnotmuch-config\fR(1) for + details. + ++Supported options for ++.B tag ++include ++.RS 4 ++.TP 4 ++.BR \-\-stdin ++ ++Read batch tagging operations from standard input. This is more ++efficient than repeated ++.B notmuch tag ++invocations. See ++.B TAG FILE FORMAT ++below for the input format. This option is not compatible with ++specifying tagging on the command line. ++.RE ++ ++.SH TAG FILE FORMAT ++ ++The input must consist of lines of the format: ++ ++.RI "T +<" tag ">|\-<" tag "> [...] [\-\-] <" search-terms ">" ++ ++Each line is interpreted similarly to ++.B notmuch tag ++command line arguments. The delimiter is one or more spaces ' '. Any ++characters in and ++.B may ++be hex encoded with %NN where NN is the hexadecimal value of the ++character. Any ' ' and '%' characters in and ++.B must ++be hex encoded (using %20 and %25, respectively). Any characters that ++are not part of or ++.B must not ++be hex encoded. ++ ++Leading and trailing space ' ' is ignored. Empty lines and lines ++beginning with '#' are ignored. ++ + .SH SEE ALSO + + \fBnotmuch\fR(1), \fBnotmuch-config\fR(1), \fBnotmuch-count\fR(1), +-- +1.7.5.4 + -- 2.26.2