From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <bremner@tethera.net>
Received: from localhost (localhost [127.0.0.1])
	by olra.theworths.org (Postfix) with ESMTP id 1B575431FC3
	for <notmuch@notmuchmail.org>; Sun,  5 Jan 2014 03:39:31 -0800 (PST)
X-Virus-Scanned: Debian amavisd-new at olra.theworths.org
X-Spam-Flag: NO
X-Spam-Score: 0
X-Spam-Level: 
X-Spam-Status: No, score=0 tagged_above=-999 required=5 tests=[none]
	autolearn=disabled
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 U+wkQf3xlDjx for <notmuch@notmuchmail.org>;
	Sun,  5 Jan 2014 03:39:23 -0800 (PST)
Received: from yantan.tethera.net (yantan.tethera.net [199.188.72.155])
	(using TLSv1 with cipher DHE-RSA-AES128-SHA (128/128 bits))
	(No client certificate requested)
	by olra.theworths.org (Postfix) with ESMTPS id DB703431FC0
	for <notmuch@notmuchmail.org>; Sun,  5 Jan 2014 03:39:23 -0800 (PST)
Received: from remotemail by yantan.tethera.net with local (Exim 4.80)
	(envelope-from <bremner@tethera.net>) id 1Vzm36-0001Y6-GR
	for notmuch@notmuchmail.org; Sun, 05 Jan 2014 07:39:20 -0400
Received: (nullmailer pid 5360 invoked by uid 1000); Sun, 05 Jan 2014
	11:39:16 -0000
From: David Bremner <david@tethera.net>
To: notmuch@notmuchmail.org
Subject: third draft of info manual
Date: Sun,  5 Jan 2014 07:39:07 -0400
Message-Id: <1388921950-5017-1-git-send-email-david@tethera.net>
X-Mailer: git-send-email 1.8.5.2
In-Reply-To: <1366852752-3584-1-git-send-email-david@tethera.net>
References: <1366852752-3584-1-git-send-email-david@tethera.net>
X-BeenThere: notmuch@notmuchmail.org
X-Mailman-Version: 2.1.13
Precedence: list
List-Id: "Use and development of the notmuch mail system."
	<notmuch.notmuchmail.org>
List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,
	<mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>
List-Archive: <http://notmuchmail.org/pipermail/notmuch>
List-Post: <mailto:notmuch@notmuchmail.org>
List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>
List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,
	<mailto:notmuch-request@notmuchmail.org?subject=subscribe>
X-List-Received-Date: Sun, 05 Jan 2014 11:39:31 -0000


Jani was mentioning how much he loved editing troff, so I decided to
dust off these patches, which as a side effect convert (some of) the
man pages to pod.

As I write this, I realized that the second commit message is sort of
a lie, I now use a quick and dirty perl script [1] to do the conversion.

I have also updated the converted pages to take into account man page
edits since April.  Since this is a semi-manual process, I don't want
to convert (and therefore have to update) all of the man pages at this
stage.

An earlier version of the series is at 

   mid:1366852752-3584-1-git-send-email-david@tethera.net


[1]:

#!/usr/bin/perl

open(POD,"groff -e -mandoc -Tascii -rHY=0 | rman -f POD|") || die;
LINE:
while(<POD>){
  my $blank=0;
  while (m/^\s*$/) {
    $_=<POD>;
    $blank++;
  }
  print "\n" if ($blank);

  while(s/^(=head1 .*)B[<]/\1/){};
  while(s/^(=head1 .*)[>]/\1/){};

  s/  */ /g;
  print;
}