\documentstyle[html]{article}
\title{l2x -- conversion from LaTeX to other formats\\Version 1.4}
\author{Henning Schulzrinne\\GMD Fokus\\Berlin, Germany\\
hgs@fokus.gmd.de}
\begin{document}
\maketitle
\section{Description}
{\tt l2x} is a general-purpose \LaTeX\ converter. It consists of a parser
written in C, which then calls Tcl functions for each \LaTeX\ function.
The Tcl functions return the translated value.

\section{Installation}

The newest version of this package is available \htmladdnormallink{by
anon.  ftp}{ftp://gaia.cs.umass.edu/pub/hgschulz/l2x/l2x-1.4.tgz}.  It
is a gzip'ed tar file.  You must have the Tcl libraries installed, for
example obtained by \htmladdnormallink{anonymous
ftp}{ftp://harbor.ecn.purdue.edu/pub/tcl}.  Edit the {\tt Makefile}
for the correct location of the Tcl library and include files and type
{\tt make}.

\section{Usage}
To translate the \LaTeX\ file {\tt input.tex} using the translator {\tt
foo.tcl}:
\begin{verbatim}
  l2x foo.tcl < paper.tex
\end{verbatim}
The application {\tt lf} is a filter that removes blank lines and,
with the {\tt -b} flag specified, initial blank space on lines.  It is
intended for nroff conversion.  The application {\tt pgstrip} removes extra
blank lines from the beginning of a page and is due to Jon Postel. 
The script {\tt fix.sh} processes an RFC or Internet Draft, including
the necessary stripping of backspaces and the conversion of FORMFEED
to real formfeeds (control-L).

Currently, the following example translators are provided:
\begin{description}
\item[l2html.tcl] Convert input to a single HTML file.
\item[ms.tcl] Convert to nroff/troff -ms macros.
Currently converts to a format suitable for FAQs and READMEs
(no page breaks or page numbers), but that is readily changed.
\end{description}

\section{Limitations}
Currently, only a subset of \LaTeX\ commands is supported. Many are easy
to add, but the following might require more work, albeit mostly limited
to writing new Tcl functions:
\begin{itemize}
\item For conversion to HTML, math mode is supported by calling LaTeX
and including the GIF image.
\item The \verb|\newenvironment| command is not supported.
\item Table of contents, etc. are not supported in nroff.
\end{itemize}

\section{Examples}
To convert nroff output to plain ASCII, without underscores, use
\begin{verbatim}
  l2x ms.tcl < foo.tex | nroff -ms | ul -tdumb > foo.txt
\end{verbatim}

\section{Copyright}
Copyright (c) 1994 Henning Schulzrinne\\
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
\begin{enumerate}
\item Redistribution for direct commercial gain requires prior
permission.
\item Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
\item Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
\item All advertising materials mentioning features or use of this software
must display the following acknowledgement:
This product includes software developed by Henning Schulzrinne.
\end{itemize}
\par
This software is provided by the author(s) ``as is'' and any express or
implied warranties, including, but not limited to, the implied
warranties of merchantability and fitness for a particular purpose are
disclaimed.  In no event shall the contributors be liable for any
direct, indirect, incidental, special, exemplary, or consequential
damages (including, but not limited to, procurement of substitute goods
or services; loss of use, data, or profits; or business interruption)
however caused and on any theory of liability, whether in contract,
strict liability, or tort (including negligence or otherwise) arising in
any way out of the use of this software, even if advised of the
possibility of such damage.

\end{document}
