CADiZ

Reference manual / Auxiliary tools / cz


SYNOPSIS

cz [-UTF8 | -UTF16BE | -UCS4] [filename]

DESCRIPTION

The cz tool reads a sequence of UCS characters from the file identified by the optional filename, default standard input, and displays the characters in a window.

The cz tool is basically just a composition of the ucs2troff, troff and proof tools. Hence characters for which troff instructions are not known are displayed using nameplates showing their UCS code positions, and troff characters not present in the screen fonts are moaned about.

OPTIONS

-UTF8 | -UTF16BE | -UCS4

Specifies the encoding that is used for the input UCS characters, default UTF8.

ENVIRONMENT

ARCH

specifies the processor architecture on which cz is to be executed. Unless you are accessing cz remotely in a heterogeneous computing network, the default is likely to be appropriate. Recognised values include irix6, solaris2 and i486.

CADIZ

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.

DISPLAY

specifies the X server of the screen on which the previewing windows should appear. If that is serving a different screen, or a different user, then it may be necessary to grant permission explicitly, perhaps using the xhost command.

EXIT STATUS

The exit status of cz is

0

if no errors are detected in the entire specification,

1

if some errors are detected in the specification,

2

if cz detects something amiss with itself.


IT 27-Jan-2002