mtex2man(1)

NAME

mtex2man - translate mtex(7) files to man format

SYNTAX

mtex2man

DESCRIPTION

mtex2man is a filter that reads a file in mtex(7) format from its standard input, and writes a man-format file to standard output suitable for viewing with nroff(1)/troff(1) and the man(7) or man.nopage(7) macro packages.

mtex2man is written entirely in LIM (see lim(1)).

SPECIAL CHARACTERS

There are two special characters for the man output format. Here are the characters and the strings they are translated to by mtex2man(1):

“-” becomes “\-”
“\” becomes “\\”

To prevent the first character from being translated within the scope of a roff environment, you must escape it with a \ (backslash) character.

Since the backslash character is the escape character used by mtex, the way to signal one in the input is by escaping it. Hence, the second translation listed above says that “\\” in the input become “\\” in the output.

DIAGNOSTICS

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

BUGS

The \tt command for typesetting in fixed-width font is currently ignored.

For now, there is no way to produce a single \ (backslash) character in a roff environment.

An escaped backslash character (\\) should not be used in arguments to the \item command within the description environment. There seems to be a problem with using backslash in arguments to certain man(7) macros.

The " (double-quote) character should not be used in arguments to the \manpage and \section commands. This problem seems to be due to a mistake in the design of nroff(1)/troff(1), which uses this character literally in some contexts but as a method of quoting in others.

Links are not indicated in any way.

SEE ALSO

mtex(7), mtex2html(1), mtex2tex(1), nroff(1), troff(1), man(7), man.nopage(7) This man page is also available as a hypertext document under Mosaic at URL http://src-www.pa.dec.com/SRC/man/DS/mtex2man.1.html.

AUTHOR OF PROGRAM AND DOCUMENTATION

Allan Heydon (heydon@src.dec.com)
    Last modified on Mon Feb  6 16:46:23 PST 1995 by heydon