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 5813C431FBC for ; Sat, 15 Dec 2012 15:10:45 -0800 (PST) X-Virus-Scanned: Debian amavisd-new at olra.theworths.org 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 iQ5TJJWC1zII for ; Sat, 15 Dec 2012 15:10:44 -0800 (PST) Received: from mail-la0-f53.google.com (mail-la0-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 9E1B6431FB6 for ; Sat, 15 Dec 2012 15:10:44 -0800 (PST) Received: by mail-la0-f53.google.com with SMTP id w12so3667606lag.26 for ; Sat, 15 Dec 2012 15:10:41 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20120113; h=from:to:cc:subject:in-reply-to:references:user-agent:date :message-id:mime-version:content-type:x-gm-message-state; bh=2NmrvSr26yim3w78IMS5lap1505McKDCxUmS4d5OXM8=; b=LkE+3YCkyWB7n4DGdbN6RY826TBFWfPTjtuBBViwh7uzwAm4w6qS06Rpm57jmc3FOA 3s8flXA+1KR02UXMTK7NP2AnA0EICJnGbEc7llZzi+HLet6LJTwpPSOcUNU5JVaVWzvp GrS0PAPimX7/PXJDkrHBAxcpXF3U8wx8CsJzW68EDK9LIdmXkb6okRNwkQUzFFItbWoe kAmTE1/vDPEmNrYR+ftJGfsbtri/BU0nE82XO00H96NPAqq3FqduCqiB41yp5JaucO3U a5MgNPfL825YS08GF0Q2Hg4fk5lfgNyGsQxRP+zAc1bLzqtqUjoIjVlZrRlSWo+DlYrb 6KMQ== Received: by 10.112.42.161 with SMTP id p1mr3957429lbl.88.1355613041816; Sat, 15 Dec 2012 15:10:41 -0800 (PST) Received: from localhost (dsl-hkibrasgw4-50df51-27.dhcp.inet.fi. [80.223.81.27]) by mx.google.com with ESMTPS id so7sm3231071lab.0.2012.12.15.15.10.39 (version=SSLv3 cipher=OTHER); Sat, 15 Dec 2012 15:10:40 -0800 (PST) From: Jani Nikula To: david@tethera.net, notmuch@notmuchmail.org Subject: Re: [PATCH] fixup for hex encoding desription in notmuch-tag.1 In-Reply-To: <1355602150-5299-1-git-send-email-david@tethera.net> References: <8762435ei4.fsf@zancas.localnet> <1355602150-5299-1-git-send-email-david@tethera.net> User-Agent: Notmuch/0.14+138~g7041c56 (http://notmuchmail.org) Emacs/23.4.1 (i686-pc-linux-gnu) Date: Sun, 16 Dec 2012 01:10:38 +0200 Message-ID: <87sj76q5ch.fsf@nikula.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Gm-Message-State: ALoCoQnzzaLv+vezKlaSxLR6R8+49qHVSibotWp8zFy+/GdGrlrSABzu6+3zYATLz2LU2W4md+sp Cc: David Bremner 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, 15 Dec 2012 23:10:45 -0000 On Sat, 15 Dec 2012, david@tethera.net wrote: > From: David Bremner > > --- > 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 and > +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 and > +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 and not > +matching the regex > +.B [A-Za-z0-9@=.,_+-] And this actually means you can't have "id:foo" there, as : needs to be encoded. Not user friendly at all. If it should really mean : is okay un-encoded as prefix delimiter but not otherwise... it gets a bit messy to document. BR, Jani. > .B must > -be hex encoded (using %20 and %25, respectively). Any characters that > -are not part of or > +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 > > _______________________________________________ > notmuch mailing list > notmuch@notmuchmail.org > http://notmuchmail.org/mailman/listinfo/notmuch