Re: [RFC] http://notmuchmail.org/searching/ [was: Re: Improving notmuch query documentation]

2012-03-19 Thread David Bremner
On Sat, 17 Mar 2012 00:29:52 +0200, Andrei POPESCU andreimpope...@gmail.com wrote: On Jo, 15 mar 12, 22:11:24, Austin Clements wrote: As I see it, the manpage (specifically section 'SEARCH SYNTAX' needs to be expanded somewhat and 'help search-terms' shortened (a lot). Does this make

[RFC] http://notmuchmail.org/searching/ [was: Re: Improving notmuch query documentation]

2012-03-17 Thread Andrei POPESCU
On Sb, 17 mar 12, 13:16:47, Austin Clements wrote: > Quoth Andrei POPESCU on Mar 17 at 4:40 pm: > > > > As I see it, the manpage (specifically section 'SEARCH SYNTAX' needs to > > > > be expanded somewhat and 'help search-terms' shortened (a lot). > > I realized that I didn't have a 'SEARCH

[RFC] http://notmuchmail.org/searching/ [was: Re: Improving notmuch query documentation]

2012-03-17 Thread Andrei POPESCU
On Vi, 16 mar 12, 20:20:17, Austin Clements wrote: > > It is, quite literally, the manpage. notmuch execs man when you run > notmuch help. Aha. > This was an intentional change a few releases ago. Previously, we did > have separate manpages and internal help documentation and it didn't > work

[RFC] http://notmuchmail.org/searching/ [was: Re: Improving notmuch query documentation]

2012-03-17 Thread Austin Clements
Quoth Andrei POPESCU on Mar 17 at 4:40 pm: > > > As I see it, the manpage (specifically section 'SEARCH SYNTAX' needs to > > > be expanded somewhat and 'help search-terms' shortened (a lot). I realized that I didn't have a 'SEARCH SYNTAX' section and went digging into notmuch's code history.

[RFC] http://notmuchmail.org/searching/ [was: Re: Improving notmuch query documentation]

2012-03-17 Thread Andrei POPESCU
On Jo, 15 mar 12, 22:11:24, Austin Clements wrote: > Quoth Andrei POPESCU on Mar 16 at 2:30 am: > > > > $ notmuch help search-terms | wc -l > > 88 > > > > IMHO that text is better suited for a manpage, the help should be just a > > (very short) reference to refresh ones memory. What do you

Re: [RFC] http://notmuchmail.org/searching/ [was: Re: Improving notmuch query documentation]

2012-03-17 Thread Andrei POPESCU
On Vi, 16 mar 12, 20:20:17, Austin Clements wrote: It is, quite literally, the manpage. notmuch execs man when you run notmuch help. Aha. This was an intentional change a few releases ago. Previously, we did have separate manpages and internal help documentation and it didn't work very

Re: [RFC] http://notmuchmail.org/searching/ [was: Re: Improving notmuch query documentation]

2012-03-17 Thread Austin Clements
Quoth Andrei POPESCU on Mar 17 at 4:40 pm: As I see it, the manpage (specifically section 'SEARCH SYNTAX' needs to be expanded somewhat and 'help search-terms' shortened (a lot). I realized that I didn't have a 'SEARCH SYNTAX' section and went digging into notmuch's code history. Are you

Re: [RFC] http://notmuchmail.org/searching/ [was: Re: Improving notmuch query documentation]

2012-03-17 Thread Andrei POPESCU
On Sb, 17 mar 12, 13:16:47, Austin Clements wrote: Quoth Andrei POPESCU on Mar 17 at 4:40 pm: As I see it, the manpage (specifically section 'SEARCH SYNTAX' needs to be expanded somewhat and 'help search-terms' shortened (a lot). I realized that I didn't have a 'SEARCH SYNTAX'

[RFC] http://notmuchmail.org/searching/ [was: Re: Improving notmuch query documentation]

2012-03-16 Thread Austin Clements
Quoth Andrei POPESCU on Mar 17 at 12:29 am: > On Jo, 15 mar 12, 22:11:24, Austin Clements wrote: > > Quoth Andrei POPESCU on Mar 16 at 2:30 am: > > > > > > $ notmuch help search-terms | wc -l > > > 88 > > > > > > IMHO that text is better suited for a manpage, the help should be just a > > >

[RFC] http://notmuchmail.org/searching/ [was: Re: Improving notmuch query documentation]

2012-03-16 Thread David Bremner
On Sat, 17 Mar 2012 00:29:52 +0200, Andrei POPESCU wrote: > On Jo, 15 mar 12, 22:11:24, Austin Clements wrote: > As I see it, the manpage (specifically section 'SEARCH SYNTAX' needs to > be expanded somewhat and 'help search-terms' shortened (a lot). > > Does this make sense? > I don't see

[RFC] http://notmuchmail.org/searching/ [was: Re: Improving notmuch query documentation]

2012-03-16 Thread David Bremner
On Fri, 16 Mar 2012 02:30:53 +0200, Andrei POPESCU wrote: > > Regarding 'notmuch help search-terms': > > $ notmuch help search-terms | wc -l > 88 > > IMHO that text is better suited for a manpage, the help should be just a > (very short) reference to refresh ones memory. What do you think? >

[RFC] http://notmuchmail.org/searching/ [was: Re: Improving notmuch query documentation]

2012-03-16 Thread Andrei POPESCU
On Jo, 15 mar 12, 17:11:08, Austin Clements wrote: > > I think having two divergent documents covering the same thing is less > than ideal, but perhaps they could be merged in the near future. I want to have this page more or less complete and descriptive. Once this is done I should be able to

Re: [RFC] http://notmuchmail.org/searching/ [was: Re: Improving notmuch query documentation]

2012-03-16 Thread David Bremner
On Fri, 16 Mar 2012 02:30:53 +0200, Andrei POPESCU andreimpope...@gmail.com wrote: Regarding 'notmuch help search-terms': $ notmuch help search-terms | wc -l 88 IMHO that text is better suited for a manpage, the help should be just a (very short) reference to refresh ones memory.

Re: [RFC] http://notmuchmail.org/searching/ [was: Re: Improving notmuch query documentation]

2012-03-16 Thread Andrei POPESCU
On Jo, 15 mar 12, 22:11:24, Austin Clements wrote: Quoth Andrei POPESCU on Mar 16 at 2:30 am: $ notmuch help search-terms | wc -l 88 IMHO that text is better suited for a manpage, the help should be just a (very short) reference to refresh ones memory. What do you think? I'm

Re: [RFC] http://notmuchmail.org/searching/ [was: Re: Improving notmuch query documentation]

2012-03-16 Thread Austin Clements
Quoth Andrei POPESCU on Mar 17 at 12:29 am: On Jo, 15 mar 12, 22:11:24, Austin Clements wrote: Quoth Andrei POPESCU on Mar 16 at 2:30 am: $ notmuch help search-terms | wc -l 88 IMHO that text is better suited for a manpage, the help should be just a (very short) reference

[RFC] http://notmuchmail.org/searching/ [was: Re: Improving notmuch query documentation]

2012-03-15 Thread Austin Clements
Quoth Andrei POPESCU on Mar 16 at 2:30 am: > On Jo, 15 mar 12, 17:11:08, Austin Clements wrote: > > > > I think having two divergent documents covering the same thing is less > > than ideal, but perhaps they could be merged in the near future. > > I want to have this page more or less complete

[RFC] http://notmuchmail.org/searching/ [was: Re: Improving notmuch query documentation]

2012-03-15 Thread Austin Clements
Quoth Andrei POPESCU on Mar 15 at 11:39 am: > On Ma, 17 ian 12, 17:29:23, Austin Clements wrote: > > Quoth Andrei Popescu on Jan 18 at 12:14 am: > > > > > > If I get around to write something myself where do you suggest I should > > > start, the wiki or the manpage? > > > > Probably expanding

[RFC] http://notmuchmail.org/searching/ [was: Re: Improving notmuch query documentation]

2012-03-15 Thread Andrei POPESCU
On Ma, 17 ian 12, 17:29:23, Austin Clements wrote: > Quoth Andrei Popescu on Jan 18 at 12:14 am: > > > > If I get around to write something myself where do you suggest I should > > start, the wiki or the manpage? > > Probably expanding man/man7/notmuch-search-terms.7 would be the way to > go.

[RFC] http://notmuchmail.org/searching/ [was: Re: Improving notmuch query documentation]

2012-03-15 Thread Andrei POPESCU
On Ma, 17 ian 12, 17:29:23, Austin Clements wrote: Quoth Andrei Popescu on Jan 18 at 12:14 am: If I get around to write something myself where do you suggest I should start, the wiki or the manpage? Probably expanding man/man7/notmuch-search-terms.7 would be the way to go. I went

Re: [RFC] http://notmuchmail.org/searching/ [was: Re: Improving notmuch query documentation]

2012-03-15 Thread Austin Clements
Quoth Andrei POPESCU on Mar 15 at 11:39 am: On Ma, 17 ian 12, 17:29:23, Austin Clements wrote: Quoth Andrei Popescu on Jan 18 at 12:14 am: If I get around to write something myself where do you suggest I should start, the wiki or the manpage? Probably expanding

Re: [RFC] http://notmuchmail.org/searching/ [was: Re: Improving notmuch query documentation]

2012-03-15 Thread Andrei POPESCU
On Jo, 15 mar 12, 17:11:08, Austin Clements wrote: I think having two divergent documents covering the same thing is less than ideal, but perhaps they could be merged in the near future. I want to have this page more or less complete and descriptive. Once this is done I should be able to

Re: [RFC] http://notmuchmail.org/searching/ [was: Re: Improving notmuch query documentation]

2012-03-15 Thread Austin Clements
Quoth Andrei POPESCU on Mar 16 at 2:30 am: On Jo, 15 mar 12, 17:11:08, Austin Clements wrote: I think having two divergent documents covering the same thing is less than ideal, but perhaps they could be merged in the near future. I want to have this page more or less complete and