[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