From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from localhost (localhost [127.0.0.1]) by olra.theworths.org (Postfix) with ESMTP id 425D8431FC1 for ; Mon, 26 Apr 2010 16:50:09 -0700 (PDT) X-Virus-Scanned: Debian amavisd-new at olra.theworths.org X-Spam-Flag: NO X-Spam-Score: -0.001 X-Spam-Level: X-Spam-Status: No, score=-0.001 tagged_above=-999 required=5 tests=[BAYES_20=-0.001] autolearn=unavailable Received: from olra.theworths.org ([127.0.0.1]) by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id Oday6BNJY0Rz for ; Mon, 26 Apr 2010 16:50:06 -0700 (PDT) Received: from pivot.cs.unb.ca (pivot.cs.unb.ca [131.202.240.57]) by olra.theworths.org (Postfix) with ESMTP id BEB004196F0 for ; Mon, 26 Apr 2010 16:50:06 -0700 (PDT) Received: from fctnnbsc30w-142167190087.pppoe-dynamic.high-speed.nb.bellaliant.net ([142.167.190.87] helo=rocinante.cs.unb.ca) by pivot.cs.unb.ca with esmtpsa (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.69) (envelope-from ) id 1O6Y3x-00053w-7K; Mon, 26 Apr 2010 20:50:05 -0300 Received: from bremner by rocinante.cs.unb.ca with local (Exim 4.71) (envelope-from ) id 1O6Y3M-0001m8-IQ; Mon, 26 Apr 2010 20:49:28 -0300 From: David Bremner To: Carl Worth Subject: Re: [PATCH] notmuch.pod: pod version of documentation, converted by rman, massaged by hand. In-Reply-To: <871ve1wzzs.fsf@yoom.home.cworth.org> References: <1262281169-24909-1-git-send-email-david@tethera.net> <87wrvxc5fi.fsf@rocinante.cs.unb.ca> <871ve1wzzs.fsf@yoom.home.cworth.org> Date: Mon, 26 Apr 2010 20:49:28 -0300 Message-ID: <87d3xldbav.fsf@rocinante.cs.unb.ca> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Sender-Verified: bremner@pivot.cs.unb.ca Cc: notmuch@notmuchmail.org X-BeenThere: notmuch@notmuchmail.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: "Use and development of the notmuch mail system." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 26 Apr 2010 23:50:09 -0000 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. Essentially I just reformatted one or two places to make the online help easier to pull out of the man pages. > * What additional tools does this require for someone to build the > tree from the git repository? A recentish version of perl. 5.8.8 (2006) seems to have the utilities we'd need. I guess if people have git, they have perl. I guess in principle we could ship the pre-processed docs in a distribution tarball. > > Should I rebase/rebuild this against the current docs, or not bother? > > I'd be interested in taking another look, if you're willing to take > another whack at it. I think that our command-line interface is changing > a lot more slowly such that this won't go immediately stale this time. Sure, I can have another go at it. d