From: David Bremner <david@tethera.net>
To: notmuch@notmuchmail.org
Subject: Re: [PATCH] notmuch.pod: pod version of documentation,
	converted by rman, massaged by hand.
In-Reply-To: <1262281169-24909-1-git-send-email-david@tethera.net>
References: <1262281169-24909-1-git-send-email-david@tethera.net>
Date: Sat, 24 Apr 2010 11:04:49 -0300
Message-ID: <87wrvxc5fi.fsf@rocinante.cs.unb.ca>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Precedence: list

On Thu, 31 Dec 2009 13:39:29 -0400, david@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