Re: [PATCH] docs: initial draft of NEWS for 0.20

Subject: Re: [PATCH] docs: initial draft of NEWS for 0.20

Date: Sun, 03 May 2015 11:01:50 +0300

To: David Bremner, notmuch@notmuchmail.org

Cc:

From: Tomi Ollila


On Fri, May 01 2015, David Bremner <david@tethera.net> wrote:

> This is meant as much to jog people's memory as to be definitive.

2 things

for consistency and markdown/news2wiki compatibility texts inside `':s
have to be changed to texts inside `` (e.g. `crypto.gpg_path`)

There is 2 interface-changing issues in notmuch-emacs-mua that IMO should
be resolved before publishing its existence:

id:"1428132606-8624-1-git-send-email-jani@nikula.org", not creating new
frame by default. this particular version has problem when notmuch-emacs-mua
is run w/o --client option.

Second is the question whether ${EMACSCLIENT} and ${EMACS} should be put
inside double quotes (") in their exec line; current code supports

EMACS='emacs -nw' notmuch-emacs-mua ...

but not

EMACS='/path to with spaces/emacs' notmuch-emacs-mua ...

I already made a patch quoting those variables -- patch is simple but
commit message not so ;/... but then I thought the "feature" we now have
is so convenient than the alternative (and did not fully finish the commit
message).

(just currently i think we should do that quoting, and if anyone cares
later add option --args for arbitrary args -- or if env var is needed
additionally handling of EMACS_ARGS environment variable (or so)).


Alternative course of action (from the release point of view) would 
be to remove mentioning notmuch-emacs-mua in 0.20 NEWS and remove
installing of notmuc-emacs-mua.1 namual page -- IIRC notmuch-emacs-mua
is not currently installed when notmuch is installed by `make install` (*)


Tomi


(*) which I personally currently feel convenient -- as notm<TAB> expands
to `notmuch ` instead of `notmuch` ;D (and i use nottoomuch-prefixed 
alternative for the time being -- with compatible superset of
notmuch-emacs-mua options) 

> ---
>  NEWS | 59 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++--
>  1 file changed, 57 insertions(+), 2 deletions(-)
>
> diff --git a/NEWS b/NEWS
> index 25e5b5a..47fc507 100644
> --- a/NEWS
> +++ b/NEWS
> @@ -10,11 +10,66 @@ There is a new `mimetype:` search prefix
>    content-type of attachments, which is now indexed. See the
>    `notmuch-search-terms` manual page for details.
>  
> +Path to gpg is now configurable
> +
> +  On systems with multiple versions of gpg, you can tell
> +  notmuch which one to use by setting `crypto.gpg_path'
> +
> +New command, `notmuch-emacs-mua'
> +
> +  This new wrapper script is intended to be a drop in replacement for
> +  mutt to compose and send mail using `notmuch-emacs'
> +
> +Emacs
> +-----
> +
> +Avoid rendering large text attachements.
> +
> +Improved rendering of CID references in HTML.
> +
> +Vim
> +---
> +
> +Vim client now respects excluded tags.
> +
> +Notmuch-Mutt
> +------------
> +
> +Support messages without Message-IDs.
> +
> +Library
> +-------
> +
> +Undeprecate single message mboxes
> +
> +  It seems more trouble to remove this feature than expected, so
> +  `notmuch new' will no longer nag about mboxes with a single message.
> +
> +New error logging facility
> +
> +  Clients should call `notmuch_database_status_string' to retrieve
> +  output formerly printed to stderr.
> +
> +Several bug fixes related to stale iterators
> +
> +New status code returning API for n_query_search_{messages,thread}
> +
> +Fix for library `install_name' on Mac OS X
> +
> +Fix for rounding of seconds
> +
>  Documentation
>  -------------
>  
> -Support for using rst2man in place of sphinx to build the
> -docmumentation has been removed.
> +Sphinx is now mandatory to build docs
> +
> +  Support for using rst2man in place of sphinx to build the
> +  docmumentation has been removed.
> +
> +Improved notmuch-search-terms.7
> +
> +  The man page `notmuch-search-terms(7)' has been extended, merging
> +  some material from the relicensed wiki.
>  
>  Contrib
>  -------
> -- 
> 2.1.4
>
> _______________________________________________
> notmuch mailing list
> notmuch@notmuchmail.org
> http://notmuchmail.org/mailman/listinfo/notmuch

Thread: