From: Tomi Ollila <tomi.ollila@iki.fi>
To: Mark Walters <markwalters1009@gmail.com>, notmuch@notmuchmail.org
Subject: Re: [PATCH] News for tree-view
In-Reply-To: <1384347013-16817-1-git-send-email-markwalters1009@gmail.com>
References: <1384347013-16817-1-git-send-email-markwalters1009@gmail.com>
User-Agent: Notmuch/0.16+119~g219c55f (http://notmuchmail.org) Emacs/24.3.1
	(x86_64-unknown-linux-gnu)
Date: Wed, 13 Nov 2013 23:53:20 +0200
Message-ID: <m2habg0y0f.fsf@guru.guru-group.fi>
MIME-Version: 1.0
Content-Type: text/plain
Precedence: list

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