unofficial mirror of notmuch@notmuchmail.org
 help / color / mirror / code / Atom feed
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	[thread overview]
Message-ID: <1388921950-5017-1-git-send-email-david@tethera.net> (raw)
In-Reply-To: <1366852752-3584-1-git-send-email-david@tethera.net>


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

  parent reply	other threads:[~2014-01-05 11:39 UTC|newest]

Thread overview: 27+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2013-03-10  2:22 [RFC patch] emacs: skeleton of texinfo manual for emacs interface david
2013-04-25  1:19 ` Second draft of info manual david
2013-04-25  1:19   ` [RFC Patch v2 1/3] info: start info documentation david
2013-04-25  1:19   ` [RFC Patch v2 2/3] man: partial conversion to pod david
2013-04-25  1:19   ` [RFC Patch v2 3/3] debian: install info files david
2014-01-05 11:39   ` David Bremner [this message]
2014-01-05 11:39     ` [PATCH 1/3] info: start info documentation David Bremner
2014-01-05 11:39     ` [PATCH 2/3] man: partial conversion to pod David Bremner
2014-01-13 21:06       ` Tomi Ollila
2014-01-14 12:06         ` David Bremner
2014-01-14 12:27           ` Tomi Ollila
2014-01-15 13:08             ` David Bremner
2014-01-15 13:08               ` [Patch v3 1/3] info: start info documentation David Bremner
2014-01-17 15:59                 ` Jani Nikula
2014-01-17 16:12                 ` Jani Nikula
2014-01-17 19:54                   ` David Bremner
2014-01-18 11:06                     ` Mark Walters
2014-01-18 12:48                       ` Tomi Ollila
2014-01-18 14:52                       ` [PATCH] emacs: help: add link to info node Mark Walters
2014-01-15 13:08               ` [Patch v3 2/3] man: partial conversion to pod David Bremner
2014-01-17 16:10                 ` Jani Nikula
2014-01-17 20:09                   ` David Bremner
2014-01-17 23:35                     ` Gregor Zattler
2014-01-18 11:11                     ` Mark Walters
2014-01-15 13:08               ` [Patch v3 3/3] debian: install info files David Bremner
2014-01-15 13:16                 ` David Bremner
2014-01-05 11:39     ` [PATCH " David Bremner

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://notmuchmail.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=1388921950-5017-1-git-send-email-david@tethera.net \
    --to=david@tethera.net \
    --cc=notmuch@notmuchmail.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://yhetil.org/notmuch.git/

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).