third draft of info manual

Subject: third draft of info manual

Date: Sun, 5 Jan 2014 07:39:07 -0400

To: notmuch@notmuchmail.org

Cc:

From: David Bremner


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;
}


Thread: