CADiZ

Reference manual / Auxiliary tools / zpp


SYNOPSIS

zpp [-UTF8 | -UTF16BE | -UCS4] [sections] filename

DESCRIPTION

The zpp tool reads the mark-up of a specification, starting from the file identified by the given filename, and outputs the corresponding sequence of UCS characters to its standard output. The sections of the specification are written in definition before use order, with operator templates moved to immediately after section headers. Those sections whose names are listed in the sections arguments are omitted from the output.

OPTIONS

-UTF8 | -UTF16BE | -UCS4

Specifies the encoding to use for the output UCS characters, default UTF8.

ENVIRONMENT

ARCH

specifies the processor architecture on which zpp is to be executed. Unless you are accessing zpp 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.

CADIZPATH

is a search path of directories in which zpp will look for files. zpp looks in the directory of toolkits $CADIZ/mip/kits/$MARKUP first, then any directories given by $CADIZPATH, and lastly in the current directory.

MARKUP

should be either latex or groff. This determines which mark-up zpp assumes is used in the files. It defaults to groff.

EXIT STATUS

The exit status of zpp is

0

if no errors are detected in the entire specification,

1

if some errors are detected in the specification,

2

if zpp detects something amiss with itself.

SEE ALSO

[Toyn02].


IT 28-Jan-2002