NAME
tnc - TDF notation compiler
SYNOPSIS
tnc [ options ] input-file [ output-file ]
DESCRIPTION
tnc translates TDF capsules to and from text. It has two input modes,
read and decode. In the first, which is default, input-file is a file
containing TDF text. In the second input-file is a TDF capsule. There
are also two output mode, encode and write. In the first, which is
default, a TDF capsule is written to output-file In the second, TDF
text is written to output-file. If the output-file argument is absent,
the standard output is used instead.
Combination of these modes give four actions: text to TDF (which is
default), TDF to text, text to text, and TDF to TDF. The last two
actions are not precise identities, but they do give equivalent files.
The TDF pretty-printer, disp(1), provides a more sophisticated TDF to
text translator, although its output cannot be used as the input to
tnc.
The form of the TDF text format and more information about tnc can be
found in the document The TDF Notation Compiler.
OPTIONS
-c or -cv or -check
Specifies that tnc should apply extra checks to input-file. For
example, simple shape checking is applied. These checks are
more efficient in read mode than in decode mode. If the -cv
option is used in write mode, all the information gleaned from
the shape checking appears in output-file.
-d or -decode
Specifies that tnc should be in decode mode. That is, that
input-file is a TDF capsule.
-e or -encode
Specifies that tnc should be in encode mode. That is, that
output-file is a TDF capsule.
-eval Specifies that tnc should simplify its input by evaluating
constant expressions as far as possible.
-expand
Specifies that tnc should expand its input by replacing all
applications of defined tokens by the token definition.
-f or -func
Causes tnc to use its alternative, functional, form for both
input and output. The options -func_in and -func_out may be
used to change the input and the output independently.
-help subject ...
Makes tnc print its help message on the given subject(s). If no
subject is given, or the subject is all, all the help messages
are printed.
-Idir Adds the directory dir to the search path used by tnc to find
included files in read mode.
-l or -lib
In decode mode, specifies that input-file is not a TDF capsule,
but a TDF library. All the capsules comprising the library are
decoded.
-Lprefix
Causes tnc to treat any external identifiers starting with
prefix to be treated as if they were declare local.
-o output-file
Gives an alternative method of specifying the output file.
-p or -print
Specifies that tnc should be in decode and write modes. That
is, that input-file is a TDF capsule and output-file should
consist of TDF text. This option makes tnc into a TDF pretty-
printer.
-q Causes tnc not to check the consistency of multiple tag or token
definitions.
-r or -read
Specifies that tnc should be in read mode. That is, that input-
file should consist of TDF text.
-t or -tsimp
Specifies that tnc should expand its input by replacing all
applications of defined tokens by the token definition and by
evaluating constant expressions as far as possible. This is
equivalent to -expand -eval.
-V In write mode, specifies that the output should be in the
"verbose" form, with no shorthand forms.
-version
Makes tnc print its version number and the version of the TDF
specification it supports.
-w or -write
Specifies that tnc should be in write mode. That is, that
output-file should consist of TDF text.
SEE ALSO
disp(1), tcc(1).
tnc(1)