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 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