Initial revision

diff --git a/mad.xml b/mad.xml
new file mode 100644 (file)
index 0000000..97c6736
--- /dev/null
+++ b/mad.xml
@@ -0,0 +1,83 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE refentry PUBLIC 
+   "-//OASIS//DTD DocBook XML V4.1.2//EN"
+   "docbook/docbookx.dtd">
+<refentry id='mad.1'>
+<refmeta>
+<refentrytitle>mad</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='source'>Open Source</refmiscinfo>
+</refmeta>
+<refnamediv id='name'>
+<refname>mad</refname>
+<refpurpose>compiler for MAD (Michigan Algorithmic Decoder)</refpurpose>
+</refnamediv>
+<refsynopsisdiv id='synopsis'>
+
+<cmdsynopsis>
+  <command>mad</command>  
+  <arg choice='opt'>-c</arg>
+  <arg choice='opt'>-d </arg>
+  <arg choice='opt'>-g </arg>
+  <arg choice='opt'>-o <replaceable>target</replaceable></arg>
+  <arg choice='opt' rep='repeat'><replaceable>file</replaceable></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+
+<para>This program is a work of reconstructive archeology, a compiler
+for the Michigan Algorithmic Decoder (MAD) language from 1962.  It first
+translates MAD code into C, then uses the local C compiler to make 
+an executable binary.</para>
+
+<para>For details on the MAD language, see the MAD reference manual
+which is shipped with the distribution and available at the project
+website.</para>
+
+</refsect1>
+
+<refsect1 id='options'><title>OPTIONS</title>
+<para>Options are as follows:</para>
+<variablelist remap='TP'>
+<varlistentry>
+<term>
+<option>-c</option>
+</term>
+<listitem>
+<para>Suppress binary-code generation, leave C translations in place.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>-d </option></term>
+<listitem>
+<para>Debug. Enables verbose progress nessages from parser and lexer.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>-o</option></term>
+<listitem>
+<para>Specify name of output binary; required if there is more 
+than one sourcefile.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>-g </option></term>
+<listitem>
+<para>Dump tuples from which code is generated.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+<para>When MAD is called as a filter, the generated C is written to
+standard output as though -c had been used.</para>
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+
+<para>Eric S. Raymond <email>esr@snark.thyrsus.com</email>.  There is
+a MAD resource page at <ulink
+url='http://www.catb.org/~esr/mad/'>http://www.catb.org/~esr/mad/</ulink>).</para>
+</refsect1> 
+</refentry>
+