[PATCH] News for tree-view

[PATCH] News for tree-view

[Mark Walters]

---
This is news for notmuch-tree. I am not sure if it is appropriate to
have this big a section but I didn't see anywhere else obvious to put
the information.

I am also not certain about what markup to be using for NEWS so that
is just a best guess.

Best wishes

Mark



 NEWS |   30 ++++++++++++++++++++++++++++++
 1 files changed, 30 insertions(+), 0 deletions(-)

diff --git a/NEWS b/NEWS
index 1cbca9f..e3297a3 100644
--- a/NEWS
+++ b/NEWS
@@ -33,6 +33,36 @@ Improved `notmuch new` performance for unchanged folders
 Emacs Interface
 ---------------
 
+`notmuch-tree` (formerly `notmuch-pick`) has been added to mainline.
+
+  `notmuch-tree` is a threaded message view for the emacs
+  interface. Each message is one line in the results and the thread
+  structure is shown using UTF-8 box drawing characters (similar to
+  Mutt's threaded view). It comes between search and show in terms of
+  amount of output and can be useful for viewing both single threads
+  and multiple threads.
+
+  Using `notmuch-tree`
+
+  The main key entries to notmuch tree are
+
+  'z' enter a query to view using notmuch tree (works in hello, search,
+    show and tree mode itself).
+  'Z' view the current query in tree notmuch tree (works from search and show)
+
+  Once in tree mode, keybindings are mostly in line with the rest of
+  notmuch and are all viewable with '?' as usual.
+
+  Customising `notmuch-tree`
+
+  `notmuch-tree` has several customisation variables. The most
+  significant is the first notmuch-tree-show-out which determines the
+  behaviour when selecting a message (with RET) in tree view. By
+  default tree view uses a split window showing the single message in
+  the bottom pane. However, if this option is set then it views the
+  whole thread in the complete window jumping to the selected message
+  in the thread. In either case command-prefix selects the other option.
+
 Tagging threads in search is now race-free
 
   Previously, adding or removing a tag from a thread in a search
-- 
1.7.9.1

Re: [PATCH] News for tree-view

[Tomi Ollila]

On Wed, Nov 13 2013, Mark Walters <markwalters1009@gmail.com> wrote:

> ---
> This is news for notmuch-tree. I am not sure if it is appropriate to
> have this big a section but I didn't see anywhere else obvious to put
> the information.
>
> I am also not certain about what markup to be using for NEWS so that
> is just a best guess.

I don't comment on content, but "layout" :D. Comments inside.
>
> Best wishes
>
> Mark
>
>
>
>  NEWS |   30 ++++++++++++++++++++++++++++++
>  1 files changed, 30 insertions(+), 0 deletions(-)
>
> diff --git a/NEWS b/NEWS
> index 1cbca9f..e3297a3 100644
> --- a/NEWS
> +++ b/NEWS
> @@ -33,6 +33,36 @@ Improved `notmuch new` performance for unchanged folders
>  Emacs Interface
>  ---------------
>  
> +`notmuch-tree` (formerly `notmuch-pick`) has been added to mainline.

Take the period (.) away at the end of "title" line. It's consistent this
way and makes our converter (news2wiki.pl) to create 3rd level title out of it.

> +  `notmuch-tree` is a threaded message view for the emacs
> +  interface. Each message is one line in the results and the thread
> +  structure is shown using UTF-8 box drawing characters (similar to
> +  Mutt's threaded view). It comes between search and show in terms of
> +  amount of output and can be useful for viewing both single threads
> +  and multiple threads.
> +
> +  Using `notmuch-tree`
> +
> +  The main key entries to notmuch tree are
> +
> +  'z' enter a query to view using notmuch tree (works in hello, search,
> +    show and tree mode itself).

Add empty line in between, perhaps align 'show' with 'enter' 

> +  'Z' view the current query in tree notmuch tree (works from search and show)

'z' "line" ends with period, 'Z' does not (?)


With these changes to NEWS looks OK in text and in notmuch-wiki formats.

Tomi

> +
> +  Once in tree mode, keybindings are mostly in line with the rest of
> +  notmuch and are all viewable with '?' as usual.
> +
> +  Customising `notmuch-tree`
> +
> +  `notmuch-tree` has several customisation variables. The most
> +  significant is the first notmuch-tree-show-out which determines the
> +  behaviour when selecting a message (with RET) in tree view. By
> +  default tree view uses a split window showing the single message in
> +  the bottom pane. However, if this option is set then it views the
> +  whole thread in the complete window jumping to the selected message
> +  in the thread. In either case command-prefix selects the other option.
> +
>  Tagging threads in search is now race-free
>  
>    Previously, adding or removing a tag from a thread in a search
> -- 
> 1.7.9.1
>
> _______________________________________________
> notmuch mailing list
> notmuch@notmuchmail.org
> http://notmuchmail.org/mailman/listinfo/notmuch

[PATCH v2] News for tree-view

[Mark Walters]

---
Update following Tomi's suggestions.

Best wishes

Mark

 NEWS |   32 ++++++++++++++++++++++++++++++++
 1 files changed, 32 insertions(+), 0 deletions(-)

diff --git a/NEWS b/NEWS
index 9434af9..d0d5300 100644
--- a/NEWS
+++ b/NEWS
@@ -33,6 +33,38 @@ Improved `notmuch new` performance for unchanged folders
 Emacs Interface
 ---------------
 
+`notmuch-tree` (formerly `notmuch-pick`) has been added to mainline
+
+  `notmuch-tree` is a threaded message view for the emacs
+  interface. Each message is one line in the results and the thread
+  structure is shown using UTF-8 box drawing characters (similar to
+  Mutt's threaded view). It comes between search and show in terms of
+  amount of output and can be useful for viewing both single threads
+  and multiple threads.
+
+  Using `notmuch-tree`
+
+  The main key entries to notmuch tree are
+
+  'z' enter a query to view using notmuch tree (works in hello,
+      search, show and tree mode itself)
+
+  'Z' view the current query in tree notmuch tree (works from search
+      and show)
+
+  Once in tree mode, keybindings are mostly in line with the rest of
+  notmuch and are all viewable with '?' as usual.
+
+  Customising `notmuch-tree`
+
+  `notmuch-tree` has several customisation variables. The most
+  significant is the first notmuch-tree-show-out which determines the
+  behaviour when selecting a message (with RET) in tree view. By
+  default tree view uses a split window showing the single message in
+  the bottom pane. However, if this option is set then it views the
+  whole thread in the complete window jumping to the selected message
+  in the thread. In either case command-prefix selects the other option.
+
 Tagging threads in search is now race-free
 
   Previously, adding or removing a tag from a thread in a search
-- 
1.7.9.1

Re: [PATCH v2] News for tree-view

[Tomi Ollila]

On Sat, Nov 16 2013, Mark Walters <markwalters1009@gmail.com> wrote:

> ---
> Update following Tomi's suggestions.

LGTM.

Tomi

>
> Best wishes
>
> Mark
>
>  NEWS |   32 ++++++++++++++++++++++++++++++++
>  1 files changed, 32 insertions(+), 0 deletions(-)
>

Re: [PATCH v2] News for tree-view

[David Bremner]

Mark Walters <markwalters1009@gmail.com> writes:

> ---
> Update following Tomi's suggestions.

pushed.

d