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

diff --git a/5a/031612bd38f9f8ac2078b606b73db9e96ee42a b/5a/031612bd38f9f8ac2078b606b73db9e96ee42a
new file mode 100644 (file)
index 0000000..d6a33b8
--- /dev/null
+++ b/5a/031612bd38f9f8ac2078b606b73db9e96ee42a
@@ -0,0 +1,184 @@
+Return-Path: <tomi.ollila@iki.fi>\r
+X-Original-To: notmuch@notmuchmail.org\r
+Delivered-To: notmuch@notmuchmail.org\r
+Received: from localhost (localhost [127.0.0.1])\r
+ by arlo.cworth.org (Postfix) with ESMTP id B497D6DE0FF1\r
+ for <notmuch@notmuchmail.org>; Sun,  3 May 2015 01:02:19 -0700 (PDT)\r
+X-Virus-Scanned: Debian amavisd-new at cworth.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: 1.097\r
+X-Spam-Level: *\r
+X-Spam-Status: No, score=1.097 tagged_above=-999 required=5 tests=[AWL=0.445, \r
+ SPF_NEUTRAL=0.652] autolearn=disabled\r
+Received: from arlo.cworth.org ([127.0.0.1])\r
+ by localhost (arlo.cworth.org [127.0.0.1]) (amavisd-new, port 10024)\r
+ with ESMTP id XIfwmQXSlomz for <notmuch@notmuchmail.org>;\r
+ Sun,  3 May 2015 01:02:17 -0700 (PDT)\r
+Received: from guru.guru-group.fi (guru.guru-group.fi [46.183.73.34])\r
+ by arlo.cworth.org (Postfix) with ESMTP id E1B716DE009A\r
+ for <notmuch@notmuchmail.org>; Sun,  3 May 2015 01:02:16 -0700 (PDT)\r
+Received: from guru.guru-group.fi (localhost [IPv6:::1])\r
+ by guru.guru-group.fi (Postfix) with ESMTP id 04B80100086;\r
+ Sun,  3 May 2015 11:01:51 +0300 (EEST)\r
+From: Tomi Ollila <tomi.ollila@iki.fi>\r
+To: David Bremner <david@tethera.net>, notmuch@notmuchmail.org\r
+Subject: Re: [PATCH] docs: initial draft of NEWS for 0.20\r
+In-Reply-To: <1430492097-17451-1-git-send-email-david@tethera.net>\r
+References: <874moi71p1.fsf@maritornes.cs.unb.ca>\r
+ <1430492097-17451-1-git-send-email-david@tethera.net>\r
+User-Agent: Notmuch/0.19+109~ge80275e (http://notmuchmail.org) Emacs/24.3.1\r
+ (x86_64-unknown-linux-gnu)\r
+X-Face: HhBM'cA~<r"^Xv\KRN0P{vn'Y"Kd;zg_y3S[4)KSN~s?O\"QPoL\r
+ $[Xv_BD:i/F$WiEWax}R(MPS`^UaptOGD`*/=@\1lKoVa9tnrg0TW?"r7aRtgk[F\r
+ !)g;OY^,BjTbr)Np:%c_o'jj,Z\r
+Date: Sun, 03 May 2015 11:01:50 +0300\r
+Message-ID: <m2bni29jip.fsf@guru.guru-group.fi>\r
+MIME-Version: 1.0\r
+Content-Type: text/plain\r
+X-BeenThere: notmuch@notmuchmail.org\r
+X-Mailman-Version: 2.1.18\r
+Precedence: list\r
+List-Id: "Use and development of the notmuch mail system."\r
+ <notmuch.notmuchmail.org>\r
+List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
+ <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
+List-Archive: <http://notmuchmail.org/pipermail/notmuch/>\r
+List-Post: <mailto:notmuch@notmuchmail.org>\r
+List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
+List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
+ <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
+X-List-Received-Date: Sun, 03 May 2015 08:02:19 -0000\r
+\r
+On Fri, May 01 2015, David Bremner <david@tethera.net> wrote:\r
+\r
+> This is meant as much to jog people's memory as to be definitive.\r
+\r
+2 things\r
+\r
+for consistency and markdown/news2wiki compatibility texts inside `':s\r
+have to be changed to texts inside `` (e.g. `crypto.gpg_path`)\r
+\r
+There is 2 interface-changing issues in notmuch-emacs-mua that IMO should\r
+be resolved before publishing its existence:\r
+\r
+id:"1428132606-8624-1-git-send-email-jani@nikula.org", not creating new\r
+frame by default. this particular version has problem when notmuch-emacs-mua\r
+is run w/o --client option.\r
+\r
+Second is the question whether ${EMACSCLIENT} and ${EMACS} should be put\r
+inside double quotes (") in their exec line; current code supports\r
+\r
+EMACS='emacs -nw' notmuch-emacs-mua ...\r
+\r
+but not\r
+\r
+EMACS='/path to with spaces/emacs' notmuch-emacs-mua ...\r
+\r
+I already made a patch quoting those variables -- patch is simple but\r
+commit message not so ;/... but then I thought the "feature" we now have\r
+is so convenient than the alternative (and did not fully finish the commit\r
+message).\r
+\r
+(just currently i think we should do that quoting, and if anyone cares\r
+later add option --args for arbitrary args -- or if env var is needed\r
+additionally handling of EMACS_ARGS environment variable (or so)).\r
+\r
+\r
+Alternative course of action (from the release point of view) would \r
+be to remove mentioning notmuch-emacs-mua in 0.20 NEWS and remove\r
+installing of notmuc-emacs-mua.1 namual page -- IIRC notmuch-emacs-mua\r
+is not currently installed when notmuch is installed by `make install` (*)\r
+\r
+\r
+Tomi\r
+\r
+\r
+(*) which I personally currently feel convenient -- as notm<TAB> expands\r
+to `notmuch ` instead of `notmuch` ;D (and i use nottoomuch-prefixed \r
+alternative for the time being -- with compatible superset of\r
+notmuch-emacs-mua options) \r
+\r
+> ---\r
+>  NEWS | 59 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++--\r
+>  1 file changed, 57 insertions(+), 2 deletions(-)\r
+>\r
+> diff --git a/NEWS b/NEWS\r
+> index 25e5b5a..47fc507 100644\r
+> --- a/NEWS\r
+> +++ b/NEWS\r
+> @@ -10,11 +10,66 @@ There is a new `mimetype:` search prefix\r
+>    content-type of attachments, which is now indexed. See the\r
+>    `notmuch-search-terms` manual page for details.\r
+>  \r
+> +Path to gpg is now configurable\r
+> +\r
+> +  On systems with multiple versions of gpg, you can tell\r
+> +  notmuch which one to use by setting `crypto.gpg_path'\r
+> +\r
+> +New command, `notmuch-emacs-mua'\r
+> +\r
+> +  This new wrapper script is intended to be a drop in replacement for\r
+> +  mutt to compose and send mail using `notmuch-emacs'\r
+> +\r
+> +Emacs\r
+> +-----\r
+> +\r
+> +Avoid rendering large text attachements.\r
+> +\r
+> +Improved rendering of CID references in HTML.\r
+> +\r
+> +Vim\r
+> +---\r
+> +\r
+> +Vim client now respects excluded tags.\r
+> +\r
+> +Notmuch-Mutt\r
+> +------------\r
+> +\r
+> +Support messages without Message-IDs.\r
+> +\r
+> +Library\r
+> +-------\r
+> +\r
+> +Undeprecate single message mboxes\r
+> +\r
+> +  It seems more trouble to remove this feature than expected, so\r
+> +  `notmuch new' will no longer nag about mboxes with a single message.\r
+> +\r
+> +New error logging facility\r
+> +\r
+> +  Clients should call `notmuch_database_status_string' to retrieve\r
+> +  output formerly printed to stderr.\r
+> +\r
+> +Several bug fixes related to stale iterators\r
+> +\r
+> +New status code returning API for n_query_search_{messages,thread}\r
+> +\r
+> +Fix for library `install_name' on Mac OS X\r
+> +\r
+> +Fix for rounding of seconds\r
+> +\r
+>  Documentation\r
+>  -------------\r
+>  \r
+> -Support for using rst2man in place of sphinx to build the\r
+> -docmumentation has been removed.\r
+> +Sphinx is now mandatory to build docs\r
+> +\r
+> +  Support for using rst2man in place of sphinx to build the\r
+> +  docmumentation has been removed.\r
+> +\r
+> +Improved notmuch-search-terms.7\r
+> +\r
+> +  The man page `notmuch-search-terms(7)' has been extended, merging\r
+> +  some material from the relicensed wiki.\r
+>  \r
+>  Contrib\r
+>  -------\r
+> -- \r
+> 2.1.4\r
+>\r
+> _______________________________________________\r
+> notmuch mailing list\r
+> notmuch@notmuchmail.org\r
+> http://notmuchmail.org/mailman/listinfo/notmuch\r