From f07cdca88e1c8ffcc5d991238140e2d58ac47204 Mon Sep 17 00:00:00 2001 From: Jani Nikula Date: Sun, 16 Dec 2012 01:10:38 +0200 Subject: [PATCH] Re: [PATCH] fixup for hex encoding desription in notmuch-tag.1 --- 2b/ba82a51e54dc5f05d40218f7ffa6e5955b4522 | 126 ++++++++++++++++++++++ 1 file changed, 126 insertions(+) create mode 100644 2b/ba82a51e54dc5f05d40218f7ffa6e5955b4522 diff --git a/2b/ba82a51e54dc5f05d40218f7ffa6e5955b4522 b/2b/ba82a51e54dc5f05d40218f7ffa6e5955b4522 new file mode 100644 index 000000000..b2e9e51eb --- /dev/null +++ b/2b/ba82a51e54dc5f05d40218f7ffa6e5955b4522 @@ -0,0 +1,126 @@ +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 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 -- 2.26.2