From: Eric S. Raymond <esr@thyrsus.com>
Date: Tue, 30 Jul 2002 23:57:53 +0000 (+0000)
Subject: XML conversion.
X-Git-Tag: 1.1~3
X-Git-Url: http://thyrsus.com/gitweb/?a=commitdiff_plain;h=767cc3c4d4405869536cf652aeb4ecd196243b96;p=letterize.git

XML conversion.
---

diff --git a/letterize.xml b/letterize.xml
index e02f185..8c703a0 100644
--- a/letterize.xml
+++ b/letterize.xml
@@ -1,39 +1,67 @@
-.TH LETTERIZE 1 "October 24, 1994"
-.SH NAME
-letterize -- phone-number to letter-mnemonic generator
-.SH SYNOPSIS
-letterize nnnnnnn
-.SH DESCRIPTION
-This program tries to help you find a letter mnemonic matching a
-given phone number.
-.P
-It emits to standard output each possible pronounceable mnemonic, one
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='letterize.1'>
+<refmeta>
+<refentrytitle>LETTERIZE</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='date'>October 24, 1994</refmiscinfo>
+</refmeta>
+<refnamediv id='name'>
+<refname>letterize </refname>
+<refpurpose> phone-number to letter-mnemonic generator</refpurpose>
+</refnamediv>
+<refsynopsisdiv id='synopsis'>
+
+<cmdsynopsis>
+  <!--  letterize nnnnnnn -->
+  <command>letterize</command>  <arg choice='plain'><replaceable>nnnnnnn</replaceable></arg>
+</cmdsynopsis>
+
+</refsynopsisdiv>
+<!-- body begins here -->
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para>This program tries to help you find a letter mnemonic matching a
+given phone number.</para>
+
+<para>It emits to standard output each possible pronounceable mnemonic, one
 per line, using the American standard mapping of dial letters to
 numbers (2 goes to ABC, 3 to DEF, 4 to GHI, 5 to JKL, 6 to MNO, 7 to
-PRS, 8 to TUV, 9 to XYZ).
-.P
-The program uses a table of pronounceable letter-triples derived from
+PRS, 8 to TUV, 9 to XYZ).</para>
+
+<para>The program uses a table of pronounceable letter-triples derived from
 a dictionary scan.  Each potential mnemonic must be such that all of
 its letter-triples are in the table to be emitted.  About 30% of
-possible triples are considered pronounceable.
-.P
-A typical 7-digit phone number has 19,683 possible mnemonics, but this
+possible triples are considered pronounceable.</para>
+
+<para>A typical 7-digit phone number has 19,683 possible mnemonics, but this
 test usually cuts the list down to a few hundred or so, a reasonable
 number to eyeball-check.  For some numbers, the list will, sadly, be
-empty.
-.P
-It's best to leave out punctuation such as dashes and parens.
-.SH BUGS
-The filtering method doesn't know what plausible medial triples are
-not reasonable at the beginnings and ends of words.
-.P
-I'm not sure what table position 0 (which is what 0 and 1 are mapped
+empty.</para>
+
+<para>It's best to leave out punctuation such as dashes and parens.</para>
+</refsect1>
+
+<refsect1 id='bugs'><title>BUGS</title>
+<para>The filtering method doesn't know what plausible medial triples are
+not reasonable at the beginnings and ends of words.</para>
+
+<para>I'm not sure what table position 0 (which is what 0 and 1 are mapped
 to) means.  If you figure it out, you tell me.  I really should have
 generated my own table, but that would have been more work than this
 seemed worth -- if your number contains either, you probably need
-to generate your mnemonic in disjoint pieces arount the digits anyway.
-.SH AUTHOR
-Eric S. Raymond <esr@snark.thyrsus.com>.  It's based on a table of
-plausible letter-triples that had no name attached to it.  Surf to
-http://www.tuxedo.org/~esr/ for updates and related resources.
+to generate your mnemonic in disjoint pieces arount the digits anyway.</para>
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>Eric S. Raymond <email>esr@snark.thyrsus.com</email>.  It's
+based on a table of plausible letter-triples that had no name attached
+to it.  Surf to <ulink
+url='http://www.tuxedo.org/~esr/'>http://www.tuxedo.org/~esr/</ulink>
+for updates and related resources.</para>
+
+</refsect1>
+</refentry>