NAME
disp - TDF pretty printer
SYNOPSIS
disp [ options ] input-file [ output-file ]
DESCRIPTION
disp translates the input TDF capsule, input-file into a human-readable
form, the layout of which reflects the structure of the underlying TDF
tree. If the output-file argument is present, this is used for output;
otherwise the standard output is used.
Whenever possible the output of disp matches the TDF specification.
The most important exception is the use of asterisks after a token name
to indicate an application of that token. Also a dash is used to
indicate the absense of an optional argument and an ellipsis (...) is
used to indicate that a token’s arguments have been skipped rather than
decoded (since the token was undeclared).
It is recommended that disp is invoked via tcc(1) using the -disp or
the -disp_t option. The -opt flag can be passed to disp by passing the
flag -Wd,-opt to tcc.
OPTIONS
-g Makes disp print any diagnostic information units within the TDF
capsule.
-ncolumns
Makes disp try to format its output to fit into a page width of
columns. The default page width is 80.
-q Makes disp ignore the specified page width and print its output
with the minimum possible indentation. This makes it run
faster, but does not make the best use of the available page
width.
-r Makes disp continue after any errors. The use of this flag is
not recommended since anything read after an error is likely to
be of very little value.
-v Makes disp print its version number and the version of the TDF
specification it supports.
-A Makes disp decode all the units it recognises (including
diagnostic and linking units) within the TDF capsule.
-D Makes disp print a simple binary dump of the input file. This
is intended for debugging purposes.
-E Makes disp report such information as the number of external
tags and tokens which it usually omits.
-S Because tokens may be defined in terms of other tokens and do
not need to be declared before they are defined, disp makes two
passes of all the token definition units. In the first pass it
extracts only the declaration information, stepping over the
main body of the definition. On the second pass all the
information is read. The -S option makes disp skip the first
pass.
-T The skip pass described under the -S option is usual done
silently, without printing any information. This is changed by
the -T option.
-U Makes disp print the usage information associated with the
external tokens and tags and also any linkage information units
within the capsule.
-V By default disp attempts to rationalise the TDF it reads. In
particular it uses the external token and tag names whenever
possible, following the token and tag bindings to find these,
and makes up names for those tokens and tags which do not have
external names. The -V option makes it not attempt any such
rationalisation, but instead to output exactly what it reads.
-W Makes disp issue a warning about every token which is used
before it is declared.
DIAGNOSTICS
The error reports if the input file is not a legal TDF capsule are
intended to aid developers writing programs which produce TDF. Thus
they try to give all the information that may be required, including
the position within the input file that the error occurred.
SEE ALSO
tcc(1).
disp(1)