From f17d6af166c7707af88a92670b726bcbcacde7da Mon Sep 17 00:00:00 2001 From: Austin Clements Date: Sat, 29 Dec 2012 13:26:29 +1900 Subject: [PATCH] [PATCH v3 5/5] man: Update notmuch-dump(1) and notmuch-restore(1) --- 47/85cff96d1a9c0e6b9c2cccb8551719cccbae9e | 124 ++++++++++++++++++++++ 1 file changed, 124 insertions(+) create mode 100644 47/85cff96d1a9c0e6b9c2cccb8551719cccbae9e diff --git a/47/85cff96d1a9c0e6b9c2cccb8551719cccbae9e b/47/85cff96d1a9c0e6b9c2cccb8551719cccbae9e new file mode 100644 index 000000000..efe9c2191 --- /dev/null +++ b/47/85cff96d1a9c0e6b9c2cccb8551719cccbae9e @@ -0,0 +1,124 @@ +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 31049431FBF + for ; Fri, 28 Dec 2012 10:27:28 -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 rhalMgFq1T0F for ; + Fri, 28 Dec 2012 10:27:27 -0800 (PST) +Received: from dmz-mailsec-scanner-1.mit.edu (DMZ-MAILSEC-SCANNER-1.MIT.EDU + [18.9.25.12]) + by olra.theworths.org (Postfix) with ESMTP id CF646429E3A + for ; Fri, 28 Dec 2012 10:26:57 -0800 (PST) +X-AuditID: 1209190c-b7fa86d000001d37-a3-50dde471bbe2 +Received: from mailhub-auth-3.mit.edu ( [18.9.21.43]) + by dmz-mailsec-scanner-1.mit.edu (Symantec Messaging Gateway) with SMTP + id 77.6C.07479.174EDD05; Fri, 28 Dec 2012 13:26:57 -0500 (EST) +Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103]) + by mailhub-auth-3.mit.edu (8.13.8/8.9.2) with ESMTP id qBSIQkNS001812; + Fri, 28 Dec 2012 13:26:46 -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 qBSIQfoi012716 + (version=TLSv1/SSLv3 cipher=AES256-SHA bits=256 verify=NOT); + Fri, 28 Dec 2012 13:26:43 -0500 (EST) +Received: from amthrax by drake.dyndns.org with local (Exim 4.77) + (envelope-from ) + id 1Toedk-0000sY-5k; Fri, 28 Dec 2012 13:26:40 -0500 +From: Austin Clements +To: notmuch@notmuchmail.org +Subject: [PATCH v3 5/5] man: Update notmuch-dump(1) and notmuch-restore(1) +Date: Fri, 28 Dec 2012 13:26:29 -0500 +Message-Id: <1356719189-2837-6-git-send-email-amdragon@mit.edu> +X-Mailer: git-send-email 1.7.10.4 +In-Reply-To: <1356719189-2837-1-git-send-email-amdragon@mit.edu> +References: <1356719189-2837-1-git-send-email-amdragon@mit.edu> +X-Brightmail-Tracker: + H4sIAAAAAAAAA+NgFrrDIsWRmVeSWpSXmKPExsUixCmqrVv45G6AweLrkhY3WrsZLZqmO1us + nstjcf3mTGYHFo+ds+6ye9y6/5rd49mqW8weWw69Zw5gieKySUnNySxLLdK3S+DKuHvpOEvB + TsGKKYdamBoYN/J1MXJySAiYSJx7uokRwhaTuHBvPVsXIxeHkMA+RonGSUtZIJwNjBJfLnxg + hHAuMkl0vJnDCuHMZZR4eW8VG0g/m4CGxLb9y8FmiQhIS+y8O5sVxGYWyJN4+GgrO4gtLOAl + sW3zeWYQm0VAVeLa1UNgNbwC9hJ/1x5ggbhDUaL72QSwmZwCDhKvppwDs4WAak7NWM46gZF/ + ASPDKkbZlNwq3dzEzJzi1GTd4uTEvLzUIl1DvdzMEr3UlNJNjOCAk+TZwfjmoNIhRgEORiUe + 3pO37wYIsSaWFVfmHmKU5GBSEuVd/gAoxJeUn1KZkVicEV9UmpNafIhRgoNZSYS3rxkox5uS + WFmVWpQPk5LmYFES572cctNfSCA9sSQ1OzW1ILUIJivDwaEkwev+GKhRsCg1PbUiLTOnBCHN + xMEJMpwHaLgkSA1vcUFibnFmOkT+FKMuR8PLG08ZhVjy8vNSpcR5xUGKBECKMkrz4ObAEsUr + RnGgt4R51UCqeIBJBm7SK6AlTEBLrHnugCwpSURISTUwrqqtFCwTTaiYx6XaasmZs0ewPvXs + 165Zr+JkDx9lOpD0t2X2f6ETVdrXJn25Ui+3TNXp9z/b9NbpPz4I9c+NEtrpY75dfcedSW+8 + tXVUmzifbXKM3Ds54cCNlFMb9vVNXB+4cYr3ImbjWe/mvRaZWGXD9viHXcuKfq+GgwaT3x06 + /tuaWeXJJyWW4oxEQy3mouJEABsbEajvAgAA +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: Fri, 28 Dec 2012 18:27:28 -0000 + +Describe the new batch-tag format. For notmuch-restore, rather than +half-heartedly duplicating the description, we now cite notmuch-dump. +--- + man/man1/notmuch-dump.1 | 11 +++++++---- + man/man1/notmuch-restore.1 | 6 ++---- + 2 files changed, 9 insertions(+), 8 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). +diff --git a/man/man1/notmuch-restore.1 b/man/man1/notmuch-restore.1 +index 6bba628..78fef52 100644 +--- a/man/man1/notmuch-restore.1 ++++ b/man/man1/notmuch-restore.1 +@@ -57,10 +57,8 @@ sup calls them). + The + .B batch-tag + dump format is intended to more robust against malformed message-ids +-and tags containing whitespace or non-\fBascii\fR(7) characters. This +-format hex-escapes all characters those outside of a small character +-set, intended to be suitable for e.g. pathnames in most UNIX-like +-systems. ++and tags containing whitespace or non-\fBascii\fR(7) characters. See ++\fBnotmuch-dump\fR(1) for details on this format. + + .B "notmuch restore" + updates the maildir flags according to tag changes if the +-- +1.7.10.4 + -- 2.26.2