ucs2troff [-UTF8 | -UTF16BE | -UCS4] [filename]
The ucs2troff tool reads a sequence of UCS characters from the file identified by the optional filename, default standard input, and writes troff instructions for similar notation to the standard output.
The translation of individual UCS characters to troff instructions is defined in $CADIZ/mip/lib/ucs2troff. Any UCS characters that are used but for which no translation is defined are translated instead to instructions to typeset their code positions.
The contents of $CADIZ/mip/lib/troffucsheader is prepended in the output.
Specifies the encoding that is used for the input UCS characters, default UTF8.
specifies the processor architecture on which ucs2troff is to be executed. Unless you are accessing ucs2troff remotely in a heterogeneous computing network, the default is likely to be appropriate. Recognised values include irix6, solaris2 and i486.
names the directory in which CADiZ is installed. In particular, executables are kept in $CADIZ/mip/bin. If that directory is in your $PATH, then it is not necessary to set the CADIZ variable.
The exit status of ucs2troff is
if no errors are detected in the entire specification,
if some errors are detected in the specification,
if ucs2troff detects something amiss with itself.