[PATCH] Expand docstrings about fcc using notmuch-insert

Keith Amidon camalot at picnicpark.org
Thu Oct 13 15:40:20 PDT 2016


Did my attempt to submit via git send-email the documentation patch
quoted below somehow not get forwarded by the list server?  I never got
a copy forwarded by the list but just assumed that it was suppressing
copies to the authors.  Having observed that folks here are usually
very good about reviewing patch submissions quickly and not having
gotten any feedback, I'm wondering if something went wrong after all...

        --- Keith

On Mon, 2016-10-10 at 21:52 -0700, Keith Amidon wrote:
> 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..cfe1931 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 whitespace can be specified by
> +quoting the whitespace with an immediately preceeding 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 whitespace can be specified by quoting
> +the whitespace with an immediately preceeding 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)))


More information about the notmuch mailing list