%  Unix manual page for the la2mml program.  It is provided as a LaTeX
%  document so that it can, itself, serve as a test case for the program.
\documentstyle[11pt]{article}

\begin{document}

\subsection*{USAGE}

\begin{verbatim}
        la2mml  [-A]  [-U]  [LaTeX-filename]
\end{verbatim}

Convert a LaTeX file to FrameMaker mml format.

\subsection*{OPTIONS}

\begin{description}

\item[{\tt -A}]	forces all paragraph tags built into the {\em la2mml} program
	to be defined, and thus entered into the \P catalog of FrameMaker.
	This is useful if you wish to see the complete repertoire of paragraph
	formats.
	The default is that only the tags actually needed for the document
	translation are defined.

\item[{\tt -U}]	causes unknown LaTeX commands
	(those that are not translated by {\em la2mml}) to be listed on
	the standard error output stream.
	Untranslated commands are also copied (as text) to
	the generated FrameMaker document.

\end{description}

\subsection*{ DESCRIPTION }

Executing the command
\begin{verbatim}
        la2mml doc.tex
\end{verbatim}
will convert the LaTeX file named ``doc.tex'' into a FrameMaker mml
file named ``doc.mml''.
The mml file is known to be compatible with FrameMaker version 2.1
on both the SUN and Macintosh platforms.

The conversion program attempts to translate every standard LaTeX construct
that can be reasonably described by a mml file.
Some constructions (such as two-dimensional mathematical expression layouts)
are simply impossible to translate.
Other constructs are only represented approximately.
The next section enumerates some deficiencies in the translation.

\subsection*{ DIFFICULT CONSTRUCTS }

Some of the major omissions from the translation scheme are listed below.
In some cases, the translations are impossible.
In other cases, the complexity of the translation would be too high
compared to the relative ease of customizing and correcting the FrameMaker
document after it has been created.

\begin{itemize}
\item
	The LaTeX picture environment is rendered as an empty frame in the
	FrameMaker document.
\item
	Complicated mathematical expressions, those laid out in two dimensions,
	will be converted into a linear string of symbols.
	However, simpler expressions such as $X_i$ and $A \rightarrow \alpha$
	are accurately rendered.
\item
	Footnotes are converted into parenthesized text embedded in the document.
\item
	New commands created with the \verb+\newcommand+ or \verb+\def+ commands
	are ignored.
	Uses of these commands, like any that {\em la2mml} has no translation for,
	are left untranslated in the FrameMaker document.
	Similarly, new environments created with
	the \verb+\newenvironment+ command are ignored.
\item
	Floating figures and tables are collected and output at the end of
	the FrameMaker document.
\item
	Only LaTeX symbols that have equivalents (or close equivalents) in
	the Times and Symbol family fonts are translated.
	Other symbols are left untranslated.
\item
	Cross-references in the LaTeX document are ignored.
	Two column output commands are ignored.
	Commands that adjust spacing between paragraphs or alter indentation
	are ignored.
\item
	LaTeX tabbing and tabular environments are rendered in FrameMaker using
	an <ETable> paragraph tag whose tab stops are positioned
	at equally spaced intervals.

	Items appearing after a use of \verb+\multicolumn+ will not be preceded
	with an appropriate number of tab characters.

	Non-elementary table items (such as parboxes) will not be
	translated properly.
\item
	The \verb+\documentstyle+ options are ignored.
	Articles, reports, chapters, etc., are all rendered using the same
	collection of FrameMaker paragraph formats.
	The created document is always created using 10pt characters for
	normal text.
\end{itemize}

\subsection*{ BUG REPORTING }
	Bugs undoubtedly exist.
	Please  report them to the author at the e-mail address below,
	and please provide a short LaTeX file that illustrates the problem.
\begin{verbatim}
        nigelh@csr.uvic.ca
\end{verbatim}	
	
	No guarantee is offered that bug repairs and requests for enhancements
	to the translator will be honored promptly.
	
	The translator is copyrighted (1991) by:
	\begin{center}
		R. Nigel Horspool			\\
		Department of Computer Science		\\
		University of Victoria, P.O. Box 3055	\\
		Victoria, BC, Canada  V8W 3P6
	\end{center}

\end{document}