Return-Path: <bremner@tethera.net>
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 67FA4431FBC
	for <notmuch@notmuchmail.org>; Sat, 15 Dec 2012 12:09:22 -0800 (PST)
X-Virus-Scanned: Debian amavisd-new at olra.theworths.org
X-Spam-Flag: NO
X-Spam-Score: 0
X-Spam-Level: 
X-Spam-Status: No, score=0 tagged_above=-999 required=5 tests=[none]
	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 1hxK7gS4M1EH for <notmuch@notmuchmail.org>;
	Sat, 15 Dec 2012 12:09:22 -0800 (PST)
Received: from tesseract.cs.unb.ca (tesseract.cs.unb.ca [131.202.240.238])
	(using TLSv1 with cipher AES256-SHA (256/256 bits))
	(No client certificate requested)
	by olra.theworths.org (Postfix) with ESMTPS id 04EA3431FB6
	for <notmuch@notmuchmail.org>; Sat, 15 Dec 2012 12:09:22 -0800 (PST)
Received: from fctnnbsc30w-142167090129.dhcp-dynamic.fibreop.nb.bellaliant.net
	([142.167.90.129] helo=zancas.localnet)
	by tesseract.cs.unb.ca with esmtpsa
	(TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72)
	(envelope-from <bremner@tethera.net>)
	id 1Tjy2z-0006ld-49; Sat, 15 Dec 2012 16:09:21 -0400
Received: from bremner by zancas.localnet with local (Exim 4.80)
	(envelope-from <bremner@tethera.net>)
	id 1Tjy2t-0001OM-JY; Sat, 15 Dec 2012 16:09:15 -0400
From: david@tethera.net
To: notmuch@notmuchmail.org
Subject: [PATCH] fixup for hex encoding desription in notmuch-tag.1
Date: Sat, 15 Dec 2012 16:09:10 -0400
Message-Id: <1355602150-5299-1-git-send-email-david@tethera.net>
X-Mailer: git-send-email 1.7.10.4
In-Reply-To: <8762435ei4.fsf@zancas.localnet>
References: <8762435ei4.fsf@zancas.localnet>
X-Spam_bar: -
Cc: David Bremner <bremner@debian.org>
X-BeenThere: notmuch@notmuchmail.org
X-Mailman-Version: 2.1.13
Precedence: list
List-Id: "Use and development of the notmuch mail system."
	<notmuch.notmuchmail.org>
List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,
	<mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>
List-Archive: <http://notmuchmail.org/pipermail/notmuch>
List-Post: <mailto:notmuch@notmuchmail.org>
List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>
List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,
	<mailto:notmuch-request@notmuchmail.org?subject=subscribe>
X-List-Received-Date: Sat, 15 Dec 2012 20:09:22 -0000

From: David Bremner <bremner@debian.org>

---
and here is the updated description.

 man/man1/notmuch-tag.1 |   19 ++++++++++++++-----
 1 file changed, 14 insertions(+), 5 deletions(-)

diff --git a/man/man1/notmuch-tag.1 b/man/man1/notmuch-tag.1
index ac2c8d7..a203f53 100644
--- a/man/man1/notmuch-tag.1
+++ b/man/man1/notmuch-tag.1
@@ -67,13 +67,22 @@ The input must consist of lines of the format:
 Each line is interpreted similarly to
 .B notmuch tag
 command line arguments. The delimiter is one or more spaces ' '. Any
-characters in <tag> and <search-term>
+characters in
+.RI < tag >
+and
+.RI < search-term >
 .B may
-be hex encoded with %NN where NN is the hexadecimal value of the
-character. Any ' ' and '%' characters in <tag> and <search-terms>
+be hex-encoded with %NN where NN is the hexadecimal value of the
+character (more precisely with %NN[%MM...] where NN, MM, etc... are
+the hexadecimal values of the bytes in the UTF-8 encoding of
+the character).  Any characters in <tag> and <search-term> not
+matching the regex
+.B [A-Za-z0-9@=.,_+-]
 .B must
-be hex encoded (using %20 and %25, respectively). Any characters that
-are not part of <tag> or <search-terms>
+be hex-encoded. Any characters that are not part of
+.RI  < tag >
+or
+.RI < search-term >
 .B must not
 be hex encoded.
 
-- 
1.7.10.4