From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from localhost (localhost [127.0.0.1]) by arlo.cworth.org (Postfix) with ESMTP id B81A06DE0A73 for ; Wed, 19 Oct 2016 03:06:28 -0700 (PDT) X-Virus-Scanned: Debian amavisd-new at cworth.org X-Spam-Flag: NO X-Spam-Score: 0.142 X-Spam-Level: X-Spam-Status: No, score=0.142 tagged_above=-999 required=5 tests=[AWL=0.152, T_RP_MATCHES_RCVD=-0.01] autolearn=disabled Received: from arlo.cworth.org ([127.0.0.1]) by localhost (arlo.cworth.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id IMYFQBU6tvua for ; Wed, 19 Oct 2016 03:06:28 -0700 (PDT) Received: from picnicpark.org (picnicpark.org [130.94.181.238]) by arlo.cworth.org (Postfix) with ESMTP id 378656DE0941 for ; Wed, 19 Oct 2016 03:06:28 -0700 (PDT) Received: (qmail 97027 invoked by uid 13806); 19 Oct 2016 10:06:27 -0000 Received: from unknown (HELO gw.picnicpark.org) (camalot@[108.225.17.54]) (envelope-sender ) by 130.94.181.238 (qmail-ldap-1.03) with AES256-SHA encrypted SMTP for ; 19 Oct 2016 10:06:27 -0000 Received: by gw.picnicpark.org (Postfix, from userid 504) id B17F812A1D8B; Wed, 19 Oct 2016 03:06:20 -0700 (PDT) X-Spam-ASN: X-Spam-Virus: No Received: from kea-tablet.picnicpark.org (cpe-76-88-55-108.san.res.rr.com [76.88.55.108]) by gw.picnicpark.org (Postfix) with ESMTPSA id 04D1812A1D89; Wed, 19 Oct 2016 03:06:17 -0700 (PDT) From: Keith Amidon To: notmuch@notmuchmail.org Subject: [PATCH] Expand docstrings about fcc using notmuch-insert Date: Wed, 19 Oct 2016 03:05:19 -0700 Message-Id: <20161019100519.2666-2-camalot@picnicpark.org> X-Mailer: git-send-email 2.10.0 In-Reply-To: <20161019100519.2666-1-camalot@picnicpark.org> References: <87d1j376y2.fsf@qmul.ac.uk> <20161019100519.2666-1-camalot@picnicpark.org> X-BeenThere: notmuch@notmuchmail.org X-Mailman-Version: 2.1.22 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: Wed, 19 Oct 2016 10:06:28 -0000 This commit expands docstrings for notmuch-fcc-dirs and notmuch-maildir-fcc-with-notmuch-insert to describe how quoted strings are processed and make the ability to configure sent folders containing whitespace more discoverable. --- emacs/notmuch-maildir-fcc.el | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/emacs/notmuch-maildir-fcc.el b/emacs/notmuch-maildir-fcc.el index 95e5650..ea75bb9 100644 --- a/emacs/notmuch-maildir-fcc.el +++ b/emacs/notmuch-maildir-fcc.el @@ -54,7 +54,10 @@ If `notmuch-maildir-use-notmuch-insert' is set (the default) then the header should be of the form \"folder +tag1 -tag2\" where folder is the folder (relative to the notmuch mailstore) to store the message in, and tag1 and tag2 are tag changes to apply to the -stored message. +stored message. This string is split using `split-string-and-unquote', +so a folder name containing spaces can be specified by +quoting each space with an immediately preceding backslash +or surrounding the entire folder name in double quotes. If `notmuch-maildir-use-notmuch-insert' is nil then the Fcc header should be the directory where the message should be @@ -230,8 +233,12 @@ should be a list of tag changes to apply to the inserted message." The fcc-header should be of the form \"folder +tag1 -tag2\" where folder is the folder (relative to the notmuch mailstore) to store the message in, and tag1 and tag2 are tag changes to apply to the -stored message. If CREATE is non-nil then create the folder if -necessary." +stored message. This string is split using `split-string-and-unquote', +so a folder name containing spaces can be specified by +quoting each space with an immediately preceding backslash +or surrounding the entire folder name in double quotes. + +If CREATE is non-nil then create the folder if necessary." (let* ((args (split-string-and-unquote fcc-header)) (folder (car args)) (tags (cdr args))) -- 2.10.0