[PATCH 1/2] News for changes from Austin Clements

[PATCH 1/2] News for changes from Austin Clements

[Austin Clements]

I fear I've fallen behind on my NEWS duties.
---
 NEWS |   64 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 64 insertions(+)

diff --git a/NEWS b/NEWS
index 2e1c054..8865ef9 100644
--- a/NEWS
+++ b/NEWS
@@ -4,6 +4,17 @@ Notmuch 0.15 (YYYY-MM-DD)
 Command-Line Interface
 ----------------------
 
+`notmuch new` no longer chokes on mboxes
+
+  `notmuch new` now rejects mbox files containing more than one
+  message, rather than treating the file as one giant message.
+
+Support for single message mboxes is deprecated
+
+  For historical reasons, `notmuch new` will index mbox files
+  containing a single message; however, this behavior is now
+  officially deprecated.
+
 Empty tag names and tags beginning with "-" are deprecated
 
   Such tags have been a frequent source of confusion and cause
@@ -12,12 +23,24 @@ Empty tag names and tags beginning with "-" are deprecated
   tags continues to be supported to allow cleanup of existing tags,
   but may be removed in a future release.
 
+Fixed `notmuch new` to skip ignored broken symlinks
+
+  `notmuch new` now correctly skips symlinks if they are in the
+  ignored files list.  Previously, it would abort when encountering
+  broken symlink, even if it was ignored.
+
 Bcc and Reply-To headers are now available in notmuch show json output
 
   The `notmuch show --format=json` now includes "Bcc" and "Reply-To" headers.
   For example notmuch Emacs client can now have these headers visible
   when the headers are added to the `notmuch-message-headers` variable.
 
+CLI callers can now request a specific output format version
+
+  `notmuch` subcommands that support structured output now support a
+  `--format-version` argument for requesting a specific version of the
+  structured output, enabling better compatibility and error handling.
+
 Emacs Interface
 ---------------
 
@@ -28,6 +51,12 @@ Removal of the deprecated `notmuch-folders` variable
   has now been removed. Any remaining users should migrate to
   `notmuch-saved-searches`.
 
+Emacs now buttonizes mid: links
+
+  mid: links are a standardized way to link to messages by message ID
+  (see RFC 2392).  Emacs now hyperlinks mid: links to the appropriate
+  notmuch search.
+
 Handle errors from bodypart insertions
 
   If displaying the text of a message in show mode causes an error (in
@@ -35,6 +64,11 @@ Handle errors from bodypart insertions
   off thread display at the offending message.  The error is now
   simply displayed in place of the message.
 
+Emacs now detects version mismatches with the notmuch CLI
+
+  Emacs now detects and reports when the Emacs interface version and
+  the notmuch CLI version are incompatible.
+
 Improved text/calendar content handling
 
   Carriage returns in embedded text/calendar content caused insertion
@@ -49,6 +83,21 @@ Disabled coding conversions when reading in `with-current-notmuch-show-message`
   corrupting the saved attachment.  This has been fixed by making
   `with-current-notmuch-show-message` disable coding conversion.
 
+Fixed errors with HTML email containing images in Emacs 24
+
+  Emacs 24 ships with a new HTML renderer that produces better output,
+  but is slightly buggy.  We work around a bug that caused it to fail
+  for HTML email containing images.
+
+Fixed handling of tags with unusual characters in them
+
+  Emacs now handles tags containing spaces, quotes, and parenthesis.
+
+Fixed buttonization of id: links without quote characters
+
+  Emacs now correctly buttonizes id: links where the message ID is not
+  quoted.
+
 Library changes
 ---------------
 
@@ -72,6 +121,21 @@ terms of amount of output and can be useful for viewing both single
 threads and multiple threads. See the notmuch-pick README file for
 further details and installation.
 
+Portability
+-----------
+
+notmuch now builds on OpenBSD.
+
+Internal test framework changes
+-------------------------------
+
+The emacsclient binary is now user-configurable
+
+  The test framework now accepts TEST_EMACSCLIENT in addition to
+  TEST_EMACS for configuring the emacsclient to use.  This is
+  necessary to avoid using an old emacsclient with a new emacs, which
+  can result in buggy behavior.
+
 Notmuch 0.14 (2012-08-20)
 =========================
 
-- 
1.7.10.4

[PATCH 2/2] news: Promote some things to a general section

[Austin Clements]

Date range search may be implemented as a library change, but it's an
important user-facing change that affects all notmuch usage.  Tag name
restrictions aren't as important, but they affect both the CLI
interface and the Emacs interface.
---
 NEWS |   40 ++++++++++++++++++++--------------------
 1 file changed, 20 insertions(+), 20 deletions(-)

diff --git a/NEWS b/NEWS
index 8865ef9..3e48501 100644
--- a/NEWS
+++ b/NEWS
@@ -1,6 +1,26 @@
 Notmuch 0.15 (YYYY-MM-DD)
 =========================
 
+General
+-------
+
+Date range search support
+
+  The `date:` prefix can now be used in queries to restrict the results
+  to only messages within a particular time range (based on the Date:
+  header) with a range syntax of `date:<since>..<until>`. Notmuch
+  supports a wide variety of expressions in `<since>` and
+  `<until>`. Please refer to the `notmuch-search-terms(7)` manual page
+  for details.
+
+Empty tag names and tags beginning with "-" are deprecated
+
+  Such tags have been a frequent source of confusion and cause
+  (sometimes unresolvable) conflicts with other syntax.  notmuch tag
+  no longer allows such tags to be added to messages.  Removing such
+  tags continues to be supported to allow cleanup of existing tags,
+  but may be removed in a future release.
+
 Command-Line Interface
 ----------------------
 
@@ -15,14 +35,6 @@ Support for single message mboxes is deprecated
   containing a single message; however, this behavior is now
   officially deprecated.
 
-Empty tag names and tags beginning with "-" are deprecated
-
-  Such tags have been a frequent source of confusion and cause
-  (sometimes unresolvable) conflicts with other syntax.  notmuch tag
-  no longer allows such tags to be added to messages.  Removing such
-  tags continues to be supported to allow cleanup of existing tags,
-  but may be removed in a future release.
-
 Fixed `notmuch new` to skip ignored broken symlinks
 
   `notmuch new` now correctly skips symlinks if they are in the
@@ -98,18 +110,6 @@ Fixed buttonization of id: links without quote characters
   Emacs now correctly buttonizes id: links where the message ID is not
   quoted.
 
-Library changes
----------------
-
-Date range search support
-
-  The `date:` prefix can now be used in queries to restrict the results
-  to only messages within a particular time range (based on the Date:
-  header) with a range syntax of `date:<since>..<until>`. Notmuch
-  supports a wide variety of expressions in `<since>` and
-  `<until>`. Please refer to the `notmuch-search-terms(7)` manual page
-  for details.
-
 New add-on tool: notmuch-pick
 -----------------------------
 
-- 
1.7.10.4

Re: [PATCH 1/2] News for changes from Austin Clements

[David Bremner]

Austin Clements <amdragon@MIT.EDU> writes:

> I fear I've fallen behind on my NEWS duties.

You're not the only one ;).

Pushed, 

d

Re: [PATCH 1/2] News for changes from Austin Clements

[Mark Walters]

On Tue, 18 Dec 2012, Austin Clements <amdragon@MIT.EDU> wrote:
> I fear I've fallen behind on my NEWS duties.
> ---
>  NEWS |   64 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  1 file changed, 64 insertions(+)
>
> diff --git a/NEWS b/NEWS
> index 2e1c054..8865ef9 100644
> --- a/NEWS
> +++ b/NEWS
> @@ -4,6 +4,17 @@ Notmuch 0.15 (YYYY-MM-DD)
>  Command-Line Interface
>  ----------------------
>  
> +`notmuch new` no longer chokes on mboxes
> +
> +  `notmuch new` now rejects mbox files containing more than one
> +  message, rather than treating the file as one giant message.
> +
> +Support for single message mboxes is deprecated
> +
> +  For historical reasons, `notmuch new` will index mbox files
> +  containing a single message; however, this behavior is now
> +  officially deprecated.
> +
>  Empty tag names and tags beginning with "-" are deprecated
>  
>    Such tags have been a frequent source of confusion and cause
> @@ -12,12 +23,24 @@ Empty tag names and tags beginning with "-" are deprecated
>    tags continues to be supported to allow cleanup of existing tags,
>    but may be removed in a future release.
>  
> +Fixed `notmuch new` to skip ignored broken symlinks
> +
> +  `notmuch new` now correctly skips symlinks if they are in the
> +  ignored files list.  Previously, it would abort when encountering
> +  broken symlink, even if it was ignored.
> +
>  Bcc and Reply-To headers are now available in notmuch show json output
>  
>    The `notmuch show --format=json` now includes "Bcc" and "Reply-To" headers.
>    For example notmuch Emacs client can now have these headers visible
>    when the headers are added to the `notmuch-message-headers` variable.
>  
> +CLI callers can now request a specific output format version
> +
> +  `notmuch` subcommands that support structured output now support a
> +  `--format-version` argument for requesting a specific version of the
> +  structured output, enabling better compatibility and error handling.
> +
>  Emacs Interface
>  ---------------
>  
> @@ -28,6 +51,12 @@ Removal of the deprecated `notmuch-folders` variable
>    has now been removed. Any remaining users should migrate to
>    `notmuch-saved-searches`.
>  
> +Emacs now buttonizes mid: links
> +
> +  mid: links are a standardized way to link to messages by message ID
> +  (see RFC 2392).  Emacs now hyperlinks mid: links to the appropriate
> +  notmuch search.
> +
>  Handle errors from bodypart insertions
>  
>    If displaying the text of a message in show mode causes an error (in
> @@ -35,6 +64,11 @@ Handle errors from bodypart insertions
>    off thread display at the offending message.  The error is now
>    simply displayed in place of the message.
>  
> +Emacs now detects version mismatches with the notmuch CLI
> +
> +  Emacs now detects and reports when the Emacs interface version and
> +  the notmuch CLI version are incompatible.
> +

I know this has already been pushed but would it be worth adding
something here saying if you get an error message "Error invoking
notmuch.  notmuch search --format=json --format-version=1
--sort=newest-first tag:inbox and tag:unread exited with status 1." it
may mean that you need to upgrade the cli notmuch?

Best wishes

Mark



>  Improved text/calendar content handling
>  
>    Carriage returns in embedded text/calendar content caused insertion
> @@ -49,6 +83,21 @@ Disabled coding conversions when reading in `with-current-notmuch-show-message`
>    corrupting the saved attachment.  This has been fixed by making
>    `with-current-notmuch-show-message` disable coding conversion.
>  
> +Fixed errors with HTML email containing images in Emacs 24
> +
> +  Emacs 24 ships with a new HTML renderer that produces better output,
> +  but is slightly buggy.  We work around a bug that caused it to fail
> +  for HTML email containing images.
> +
> +Fixed handling of tags with unusual characters in them
> +
> +  Emacs now handles tags containing spaces, quotes, and parenthesis.
> +
> +Fixed buttonization of id: links without quote characters
> +
> +  Emacs now correctly buttonizes id: links where the message ID is not
> +  quoted.
> +
>  Library changes
>  ---------------
>  
> @@ -72,6 +121,21 @@ terms of amount of output and can be useful for viewing both single
>  threads and multiple threads. See the notmuch-pick README file for
>  further details and installation.
>  
> +Portability
> +-----------
> +
> +notmuch now builds on OpenBSD.
> +
> +Internal test framework changes
> +-------------------------------
> +
> +The emacsclient binary is now user-configurable
> +
> +  The test framework now accepts TEST_EMACSCLIENT in addition to
> +  TEST_EMACS for configuring the emacsclient to use.  This is
> +  necessary to avoid using an old emacsclient with a new emacs, which
> +  can result in buggy behavior.
> +
>  Notmuch 0.14 (2012-08-20)
>  =========================
>  
> -- 
> 1.7.10.4
>
> _______________________________________________
> notmuch mailing list
> notmuch@notmuchmail.org
> http://notmuchmail.org/mailman/listinfo/notmuch