From: Jani Nikula Date: Sat, 14 Apr 2012 12:15:31 +0000 (+0300) Subject: [PATCH v2 6/6] man: document notmuch tag --stdin option X-Git-Url: http://git.tremily.us/gitweb.cgi?a=commitdiff_plain;h=71e8f08d0f9d0f574de60e433bb8520bd93f9e8e;p=notmuch-archives.git [PATCH v2 6/6] man: document notmuch tag --stdin option --- diff --git a/f9/c753636900db373720aa9863541f4a763076fe b/f9/c753636900db373720aa9863541f4a763076fe new file mode 100644 index 000000000..4923bd204 --- /dev/null +++ b/f9/c753636900db373720aa9863541f4a763076fe @@ -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 A3981429E28 + for ; Sat, 14 Apr 2012 05:16:24 -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 Cq1lOZiJ75Lt for ; + Sat, 14 Apr 2012 05:16:23 -0700 (PDT) +Received: from mail-lpp01m010-f53.google.com (mail-lpp01m010-f53.google.com + [209.85.215.53]) (using TLSv1 with cipher RC4-SHA (128/128 bits)) + (No client certificate requested) + by olra.theworths.org (Postfix) with ESMTPS id 9E5D7431FD6 + for ; Sat, 14 Apr 2012 05:16:00 -0700 (PDT) +Received: by mail-lpp01m010-f53.google.com with SMTP id c1so3043779lah.26 + for ; Sat, 14 Apr 2012 05:16:00 -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=K8fZZf6zicqeanv7LhjLQLmCPDKPyPmsBuwbxOj+Kwn958tUAXFTROaolVBmIiESAk + bSZM4qValNQuSHud/69EJATzvPhxAKdbiYLUYApYhjhvKC37uZ+ZyMKMJCOZp9sjW+HE + Dw7UfkQ0PSgljV9VCXbevw4lgdoNINLB4L4i8MrFO5OlrHE1RMPeIvf7IKgndwdznCsk + DaEt0rPxllwwqHZBFKlwKUVmqwgwJgNgqcTNuCFosb3GyRwL8s5vVsdpqmyThwGiCYZg + hKl/6xEzdK2ul5qOrf2fBy0s8SO+WCLkabSc+rfLfRX+UNMvnzeGr1eVd7r/91VYQrpt + PzXA== +Received: by 10.112.27.136 with SMTP id t8mr2231377lbg.89.1334405760232; + Sat, 14 Apr 2012 05:16:00 -0700 (PDT) +Received: from localhost (dsl-hkibrasgw4-fe50dc00-68.dhcp.inet.fi. + [80.220.80.68]) + by mx.google.com with ESMTPS id fe6sm16010016lbb.9.2012.04.14.05.15.58 + (version=SSLv3 cipher=OTHER); Sat, 14 Apr 2012 05:15:59 -0700 (PDT) +From: Jani Nikula +To: notmuch@notmuchmail.org +Subject: [PATCH v2 6/6] man: document notmuch tag --stdin option +Date: Sat, 14 Apr 2012 15:15:31 +0300 +Message-Id: + <98c21f1e37b89ee67b441c76825d5f91e4fb5d7d.1334404979.git.jani@nikula.org> +X-Mailer: git-send-email 1.7.5.4 +In-Reply-To: +References: +In-Reply-To: +References: +X-Gm-Message-State: + ALoCoQmxRKSrbwwvuxXeT8z70gqOkE3UpRoGMczV+IN5bR/55cmFxeYUUeDWwvSC3PhAywXe3q45 +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, 14 Apr 2012 12:16:25 -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 +