## mtex2tex(1)

### NAME

> mtex2tex - translate mtex(7) files to LaTeX format

### SYNTAX

> mtex2tex

### DESCRIPTION

> mtex2tex is a filter that reads a file in mtex(7) format from its standard input, and writes a LaTeX-format file to standard output suitable for processing with latex(1).

> In the output produced by mtex2tex, the title of the manpage is a LaTeX `\section`, and the sections of the manpage are LaTeX `\subsection`s. The output does not contain a `\documentstyle` declaration, nor `\begin{document}` and `\end{document}` environment brackets. It is assumed that the output from this filter will be `\input` into some other top-level LaTeX document containing these commands, like this:

>       \documentstyle{article}
>       \begin{document}
>       \title{The \it{mtex} Package Manpages}
>       \author{Harvey Throgenbottom}
>       \date{\today}
>       \maketitle
>       \input{mtex.7.tex}
>       \input{mtex2html.1.tex}
>       \input{mtex2man.1.tex}
>       \input{mtex2tex.1.tex}
>       \end{document}

> mtex2tex is written entirely in LIM (see lim(1)).

### SPECIAL CHARACTERS

> There are several special characters for the LaTeX output format. Here are the characters and the strings they are translated to by mtex2tex(1):

> "`$`" becomes "`\$`"
> "`&`" becomes "`\&`"
> "`%`" becomes "`\%`"
> "`#`" becomes "`\#`"
> "`_`" becomes "`\_`"
> "`{`" becomes "`\{`"
> "`}`" becomes "`\}`"
> "`~`" becomes "`{\tt\symbol{'176}}`"
> "`^`" becomes "`{\tt\symbol{'136}}`"
> "`\`" becomes "`{\tt\symbol{'134}}`"

> To prevent these characters from being translated within the scope of a tex environment, you must escape them with a `\` (backslash) character.

### DIAGNOSTICS

> See the Diagnostics section of the mtex(7) manpage for a complete description.

### BUGS

> There is no way to specify that the space following a period should be the interword space in the case that the period does not end the sentence. Similarly, there is no way to indicate that a period following an uppercase letter actually ends a sentence.

> By default, most LaTeX document styles do not skip a line to start a new paragraph. Instead, they indent the first line of the paragraph. This can lead to formatting anomalies compared to the HTML- and man-formatted versions of a manpage.

> By default, most LaTeX document styles skip a line between list environment items, even if no new paragraph is indicated between them.

> By default, most LaTeX document styles skip a line before the first line of an environment and after the last line of the environment, even if no new paragraph is indicated there.

> The text following items in a description environment does not start on a new line.

> Links are not indicated in any way.

### SEE ALSO

> mtex(7), mtex2html(1), mtex2man(1), xmosaic(1)

### AUTHOR OF PROGRAM AND DOCUMENTATION

> Allan Heydon (`heydon@src.dec.com`)

>     Last modified on Mon Feb  6 16:46:23 PST 1995 by heydon