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 B3AEA6DE0931 for ; Wed, 28 Sep 2016 03:03:55 -0700 (PDT) X-Virus-Scanned: Debian amavisd-new at cworth.org X-Spam-Flag: NO X-Spam-Score: -0.006 X-Spam-Level: X-Spam-Status: No, score=-0.006 tagged_above=-999 required=5 tests=[AWL=-0.136, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, FREEMAIL_ENVFROM_END_DIGIT=0.25, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H3=-0.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_PASS=-0.001] 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 4HPqbdrzqgwe for ; Wed, 28 Sep 2016 03:03:55 -0700 (PDT) Received: from mail-wm0-f65.google.com (mail-wm0-f65.google.com [74.125.82.65]) by arlo.cworth.org (Postfix) with ESMTPS id DE8536DE0173 for ; Wed, 28 Sep 2016 03:03:54 -0700 (PDT) Received: by mail-wm0-f65.google.com with SMTP id b184so5136871wma.3 for ; Wed, 28 Sep 2016 03:03:54 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:date:message-id; bh=GpK3FbapzJihLMMU8I1DRnQM3ghXFTzgW8mNAFOV0rI=; b=dFh6ZIBRys0cQsWHQausTNg4/8HwvX68PeLARZWWlPLB0Pj3mN0M5AmiNB9N7Ilg8b kdJ8JJh9etVzSiIPGkr+TMuynOm8M8PDIBKtitivrnT1tGw77YJtqgKT+bNoTJcM0Gah qIsgs+d53WMwERI3GxYthQBc/b2LFvIA+hjS3EPoXW4qq+pxHLtviDjJMqYlWHwT4+/r Vv2Ft1/0KDgwGa1PtZpbFA61h+I4qiQySCKOkywyURirxbSHbcGs5K2bSr/fCo7fd/aE nrTW7drjti6kBXpBRT0YJAv/X4raYXlQYMGx5R8yBX6Q2/TwN3/XDYh8rABny38+dZIp JDzA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id; bh=GpK3FbapzJihLMMU8I1DRnQM3ghXFTzgW8mNAFOV0rI=; b=UI5E1eKPH84kEgHEDGNB1zn39EVHP5xm+sKA9pCjrp7uZc7HJPPR1LpvcgLI1xQ88W GyeSCvlU94cNQbIZCduuI8asJhkhi/RDkRjYhFuYGEjjh6rX5ysZ6JmrTWAz2pmlE99H h92p/uhos5kUYGCAhj0nmuNolbaCLwi0UACMd6aJadLf0g+k5eyV6LvUTG/qKi44nLXZ xCahBpfkyN1gqEMoAXQB9B8hdmzAXKeK6/ZlRUGw8JjSM1kYwOgocMEwAXI5rFUu+hS8 U8OwhM9Xa4GTWNYHtRqDXPpd6ldDp9D70GFJG5WGXU0Cy5om+AT3km2W+S7OcYvxlS61 LKhQ== X-Gm-Message-State: AA6/9RkuFHXG7x6P1s8SKKE8HhuTdRNfaKClUBPF3bRSCxZSqN7uj32O+z4NxD6hdtivpw== X-Received: by 10.28.230.147 with SMTP id e19mr6942193wmi.107.1475057032879; Wed, 28 Sep 2016 03:03:52 -0700 (PDT) Received: from localhost (5751dfa2.skybroadband.com. [87.81.223.162]) by smtp.gmail.com with ESMTPSA id b193sm14744707wmg.18.2016.09.28.03.03.48 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 28 Sep 2016 03:03:49 -0700 (PDT) From: Mark Walters To: notmuch@notmuchmail.org Subject: [PATCH] emacs: document notmuch-fcc-dirs Date: Wed, 28 Sep 2016 11:03:46 +0100 Message-Id: <1475057026-30205-1-git-send-email-markwalters1009@gmail.com> X-Mailer: git-send-email 2.1.4 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, 28 Sep 2016 10:03:55 -0000 This updates the docstring for the variable notmuch-fcc-dirs to match the new insert code. --- Jani pointed out on irc that I had forgotten to update this docstring. As using notmuch insert for fcc is now the default this is particularly important. Best wishes Mark emacs/notmuch-maildir-fcc.el | 24 ++++++++++++++++-------- 1 file changed, 16 insertions(+), 8 deletions(-) diff --git a/emacs/notmuch-maildir-fcc.el b/emacs/notmuch-maildir-fcc.el index 1218c01..3587d04 100644 --- a/emacs/notmuch-maildir-fcc.el +++ b/emacs/notmuch-maildir-fcc.el @@ -30,14 +30,14 @@ (defvar notmuch-maildir-fcc-count 0) (defcustom notmuch-fcc-dirs "sent" - "Determines the maildir directory in which to save outgoing mail. + "Determines the Fcc Header which says where to save outgoing mail. Three types of values are permitted: - nil: no Fcc header is added, -- a string: the value of `notmuch-fcc-dirs' is the name of the - folder to use, +- a string: the value of `notmuch-fcc-dirs' is the Fcc header to + be used. - a list: the folder is chosen based on the From address of the current message using a list of regular expressions and @@ -50,12 +50,20 @@ Three types of values are permitted: If none of the regular expressions match the From address, no Fcc header will be added. -In all cases, a relative FCC directory will be understood to -specify a directory within the notmuch mail store, (as set by -the database.path option in the notmuch configuration file). +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. + +If `notmuch-maildir-use-notmuch-insert' is nil then the Fcc +header should be the directory where the message should be +saved. A relative directory will be understood to specify a +directory within the notmuch mail store, (as set by the +database.path option in the notmuch configuration file). -You will be prompted to create the directory if it does not exist -yet when sending a mail." +In all cases you will be prompted to create the folder or +directory if it does not exist yet when sending a mail." :type '(choice (const :tag "No FCC header" nil) -- 2.1.4