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

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

Date: Mon, 26 Apr 2010 11:56:44 +0100

To: David Bremner, notmuch@notmuchmail.org

Cc:

From: David Edmondson

On Sat, 24 Apr 2010 11:04:49 -0300, David Bremner <david@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 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?

I like the idea, but I have no experience with pod.

dme.
-- 
David Edmondson, http://dme.org

• Previous message (by thread): Re: [PATCH 3/4] Add rules to build notmuch.1 and notmuch-help.h from the pod file.

Thread:

• david@tethera.net—[notmuch] [PATCH] notmuch.pod: pod version of documentation, converted by rman, massaged by hand. [inbox, unread]
  • David Bremner—Re: [PATCH] notmuch.pod: pod version of documentation, converted by rman, massaged by hand. [inbox, unread]
    • David Edmondson—Re: [PATCH] notmuch.pod: pod version of documentation, converted by rman, massaged by hand. [inbox, unread]
    • Carl Worth—Re: [PATCH] notmuch.pod: pod version of documentation, converted by rman, massaged by hand. [inbox, signed, unread]
      • David Bremner—Re: [PATCH] notmuch.pod: pod version of documentation, converted by rman, massaged by hand. [inbox, unread]
        • david@tethera.net—[PATCH] notmuch.pod: pod version of documentation, converted by rman, massaged by hand. [inbox, unread]
          • Carl Worth—Re: [PATCH] notmuch.pod: pod version of documentation, converted by rman, massaged by hand. [inbox, signed, unread]
            • david@tethera.net—generate help from pod. [inbox, unread]
            • david@tethera.net—[PATCH 1/4] notmuch.pod: pod version of documentation, converted by rman, massaged by hand. [inbox, notmuch::patch, notmuch::wontfix, unread]
            • david@tethera.net—[PATCH 2/4] Perl script to generate online help. [inbox, notmuch::patch, notmuch::wip, notmuch::wontfix, unread]
            • david@tethera.net—[PATCH 3/4] Add rules to build notmuch.1 and notmuch-help.h from the pod file. [inbox, notmuch::patch, notmuch::wontfix, unread]
              • David Bremner—Re: [PATCH 3/4] Add rules to build notmuch.1 and notmuch-help.h from the pod file. [inbox, unread]
            • david@tethera.net—[PATCH 4/4] notmuch.c: use help strings generated from notmuch.pod. [inbox, notmuch::patch, notmuch::wontfix, unread]