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

David Bremner david at tethera.net
Sat Apr 24 07:04:49 PDT 2010


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
> 
>    podselect -section 'Commands/subcommand.*' notmuch.pod | pod2text -c
> 

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 be nice to avoid maintaining two copies of the
documentation.

Should I rebase/rebuild this against the current docs, or not bother?

d


More information about the notmuch mailing list