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 63029431FAE for ; Mon, 24 Dec 2012 21:58:18 -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 WmHJaKOpqKQs for ; Mon, 24 Dec 2012 21:58:17 -0800 (PST) Received: from dmz-mailsec-scanner-6.mit.edu (DMZ-MAILSEC-SCANNER-6.MIT.EDU [18.7.68.35]) by olra.theworths.org (Postfix) with ESMTP id 3C9C5431FBC for ; Mon, 24 Dec 2012 21:58:14 -0800 (PST) X-AuditID: 12074423-b7ef96d000000725-46-50d94075281e Received: from mailhub-auth-1.mit.edu ( [18.9.21.35]) by dmz-mailsec-scanner-6.mit.edu (Symantec Messaging Gateway) with SMTP id 3F.D0.01829.57049D05; Tue, 25 Dec 2012 00:58:13 -0500 (EST) Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103]) by mailhub-auth-1.mit.edu (8.13.8/8.9.2) with ESMTP id qBP5wCij011702; Tue, 25 Dec 2012 00:58:12 -0500 Received: from drake.dyndns.org (c-76-21-105-205.hsd1.ca.comcast.net [76.21.105.205]) (authenticated bits=0) (User authenticated as amdragon@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.6/8.12.4) with ESMTP id qBP5w7is011709 (version=TLSv1/SSLv3 cipher=AES256-SHA bits=256 verify=NOT); Tue, 25 Dec 2012 00:58:10 -0500 (EST) Received: from amthrax by drake.dyndns.org with local (Exim 4.77) (envelope-from ) id 1TnNWg-0001Xw-Uw; Tue, 25 Dec 2012 00:58:06 -0500 From: Austin Clements To: notmuch@notmuchmail.org Subject: [PATCH 5/5] man: Update notmuch-dump(1) for new batch-tag format Date: Tue, 25 Dec 2012 00:57:56 -0500 Message-Id: <1356415076-5692-6-git-send-email-amdragon@mit.edu> X-Mailer: git-send-email 1.7.10.4 In-Reply-To: <1356415076-5692-1-git-send-email-amdragon@mit.edu> References: <1356415076-5692-1-git-send-email-amdragon@mit.edu> X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFjrPIsWRmVeSWpSXmKPExsUixCmqrFvqcDPAYM5yPYsbrd2MFk3TnS1W z+WxuH5zJrMDi8fOWXfZPW7df83u8WzVLWaPLYfeMwewRHHZpKTmZJalFunbJXBldE3pYS1Y xFXR25XSwLiGo4uRk0NCwETi4KWjLBC2mMSFe+vZuhi5OIQE9jFKdG26xgzhbGCU2L/gH1Tm IpPE9rkgLSDOXEaJt49PM4L0swloSGzbvxzMFhGQlth5dzYriM0skCfx8NFWdhBbWMBT4nvr TSYQm0VAVeLrglawGl4Be4lZnxtZIe5QlOh+NoENxOYUcJCY+2cl2H1CQDVf525mmcDIv4CR YRWjbEpulW5uYmZOcWqybnFyYl5eapGumV5uZoleakrpJkZQuLG7KO9g/HNQ6RCjAAejEg/v iak3AoRYE8uKK3MPMUpyMCmJ8r62uxkgxJeUn1KZkVicEV9UmpNafIhRgoNZSYTXhAcox5uS WFmVWpQPk5LmYFES572WctNfSCA9sSQ1OzW1ILUIJivDwaEkwfsHZKhgUWp6akVaZk4JQpqJ gxNkOA/QcEl7kOHFBYm5xZnpEPlTjIpS4rw/QZoFQBIZpXlwvbB08IpRHOgVYd7ZIFU8wFQC 1/0KaDAT0OBYvhsgg0sSEVJSDYzsN9xM3sctWbvXyKp1f7TuttOXXBmX2hfnnpkr8H+SS6nv Ovlb84xFePt+TKk/cizqt0DG2Ux+27Wd/7tmSztmNN7a+G6l1aIVTrvNb30JN5L2D16gdUVp a868ucHuUz0368zoaHi1rqGs/MvTYumsCK+bP2ZP9sk62PVi9rxisf9qxnImf6SVWIozEg21 mIuKEwFMQQ964gIAAA== 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: Tue, 25 Dec 2012 05:58:18 -0000 --- man/man1/notmuch-dump.1 | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/man/man1/notmuch-dump.1 b/man/man1/notmuch-dump.1 index 770b00f..7bd6def 100644 --- a/man/man1/notmuch-dump.1 +++ b/man/man1/notmuch-dump.1 @@ -64,13 +64,16 @@ and tags containing whitespace or non-\fBascii\fR(7) characters. Each line has the form .RS 4 -.RI "+<" "encoded-tag" "> " "" "+<" "encoded-tag" "> ... -- " "" " id:<" encoded-message-id > +.RI "+<" "encoded-tag" "> " "" "+<" "encoded-tag" "> ... -- " "" " id:<" quoted-message-id > -where encoded means that every byte not matching the regex +Tags are hex-encoded by replacing every byte not matching the regex .B [A-Za-z0-9@=.,_+-] -is replace by +with .B %nn -where nn is the two digit hex encoding. +where nn is the two digit hex encoding. The message ID is a valid Xapian +query, quoted using Xapian boolean term quoting rules: if the ID contains +whitespace or a close paren or starts with a double quote, it must be +enclosed in double quotes and double quotes inside the ID must be doubled. The astute reader will notice this is a special case of the batch input format for \fBnotmuch-tag\fR(1); note that the single message-id query is mandatory for \fBnotmuch-restore\fR(1). -- 1.7.10.4