[PATCH] notmuch.pod: pod version of documentation, converted by rman, massaged by hand.

2010-10-29 Thread Carl Worth
On Sun, 13 Jun 2010 12:01:30 -0300, david at tethera.net wrote: > We can also generate man pages and inline help from this file. I > didn't get that far yet, waiting for more encouraging noises :). Hi David, Having added some documentation recently, I do continue to be annoyed by the need to add

[PATCH] notmuch.pod: pod version of documentation, converted by rman, massaged by hand.

2010-06-13 Thread da...@tethera.net
From: David Bremner Some places I deleted a bit of the continuity text introducing a command because I didn't see how to make it work with the slightly more structured layout. I also moved show in front of search, because it explains the output formats. Probably it would make

[PATCH] notmuch.pod: pod version of documentation, converted by rman, massaged by hand.

2010-06-13 Thread david
From: David Bremner brem...@unb.ca Some places I deleted a bit of the continuity text introducing a command because I didn't see how to make it work with the slightly more structured layout. I also moved show in front of search, because it explains the output formats. Probably it would make

[PATCH] notmuch.pod: pod version of documentation, converted by rman, massaged by hand.

2010-04-26 Thread David Bremner
On Mon, 26 Apr 2010 16:33:27 -0700, Carl Worth wrote: > > I tried to look at it a couple of times, but it was already stale then > so I didn't look hard enough. > > The couple of questions I have are: > > * How close does the generated output match what we have today? Pretty close, I think.

[PATCH] notmuch.pod: pod version of documentation, converted by rman, massaged by hand.

2010-04-26 Thread Carl Worth
-- carl.d.worth at intel.com On Sat, 24 Apr 2010 11:04:49 -0300, David Bremner wrote: > As I'm faced with writing docs for output selection, I'd like to revisit > this idea. I didn't get any feedback, positive or negative about the > idea of keeping the docs in pod. I don't care much about the

[PATCH] notmuch.pod: pod version of documentation, converted by rman, massaged by hand.

2010-04-26 Thread David Edmondson
On Sat, 24 Apr 2010 11:04:49 -0300, David Bremner wrote: > As I'm faced with writing docs for output selection, I'd like to revisit > this idea. I didn't get any feedback, positive or negative about the > idea of keeping the docs in pod. I don't care much about the format, > but I think it would

Re: [PATCH] notmuch.pod: pod version of documentation, converted by rman, massaged by hand.

2010-04-26 Thread David Edmondson
On Sat, 24 Apr 2010 11:04:49 -0300, David Bremner da...@tethera.net wrote: As I'm faced with writing docs for output selection, I'd like to revisit this idea. I didn't get any feedback, positive or negative about the idea of keeping the docs in pod. I don't care much about the format, but I

Re: [PATCH] notmuch.pod: pod version of documentation, converted by rman, massaged by hand.

2010-04-26 Thread David Bremner
On Mon, 26 Apr 2010 16:33:27 -0700, Carl Worth cwo...@cworth.org wrote: I tried to look at it a couple of times, but it was already stale then so I didn't look hard enough. The couple of questions I have are: * How close does the generated output match what we have today? Pretty

[PATCH] notmuch.pod: pod version of documentation, converted by rman, massaged by hand.

2010-04-24 Thread David Bremner
On Thu, 31 Dec 2009 13:39:29 -0400, david at tethera.net wrote: > > The idea here is to be able to generate the online help and the man page from > one source. > > To generate a man page: > >pod2man notmuch.pod > notmuch.1 > > To generate help for a specific notmuch subcommand > >

Re: [PATCH] notmuch.pod: pod version of documentation, converted by rman, massaged by hand.

2010-04-24 Thread David Bremner
On Thu, 31 Dec 2009 13:39:29 -0400, da...@tethera.net wrote: The idea here is to be able to generate the online help and the man page from one source. To generate a man page: pod2man notmuch.pod notmuch.1 To generate help for a specific notmuch subcommand podselect

[notmuch] [PATCH] notmuch.pod: pod version of documentation, converted by rman, massaged by hand.

2009-12-31 Thread da...@tethera.net
From: David Bremner Some places I deleted a bit of the continuity text introducing a command because I didn't see how to make it work with the slightly more structured layout. --- The idea here is to be able to generate the online help and the man page from one source. To