dxvdoc(1X) dxvdoc(1X)
Name
dxvdoc - invokes CDA Viewer for DECwindows displays
Syntax
dxvdoc [ -f format ] [ -O options_file ] [-r] [-w paper_width] [-h paper_height] inputfile
Description
The command invokes the CDA Viewer, which enables you to view the input file on a workstation running DECwindows. If inputfile is not
specified, reads from standard input. The window contains a menu bar with menu items that allow you to view additional documents, change
processing options, close open documents, or exit.
If you invoke with no input file argument, you can specify the first document using the file selection box. If you want to read from stan-
dard input, you must enter "-" as the file argument. For example:
% cdoc -s text file.lis | dxvdoc -
Options
-f format Specifies the format of inputfile and invokes an appropriate input converter as part of CDA. The ddif, dtif, and text
converters are provided in the base system kit. Additional converters can be added by the CDA Converter Library and
other layered products. Contact your system manager for a complete list of input formats supported on your system. The
default format is ddif.
-O options_file Names the file passed to the input converter to control specific processing options in that converter. Refer to your
documentation set for a description of converter options.
The options file has a default file type of .cda_options. Each line of the options file specifies a format name that
can optionally be followed by _input or _output to restrict the option to either input or output. The second word is a
valid option preceded by one or more spaces, tabs, or a slash (/) and can contain upper- and lowercase letters, num-
bers, dollar signs, and underlines. The case of letters is not significant. If an option requires a value, then spaces,
tabs, or an equal sign can separate the option from the value.
Each line can optionally be preceded by spaces and tabs and can be terminated by any character other than those that
can be used to specify the format names and options. The syntax and interpretation of the text that follows the format
name is specified by the supplier of the front and back ends for the specified format.
To specify several options for the same input or output format, specify one option on a line. If an invalid option for
an input or output format or an invalid value for an option is specified, the option may be ignored or an error message
may be returned. Each input or output format that supports processing options specifies any restrictions or special
formats required when specifying options.
By default, any messages that occur during processing of the options file are written to the system standard error
location. For those input formats that support a LOG option, messages can be directed to a log file.
-r Specifies that the CDA Viewer is to override the format of the document. If the - -r qualifier is not specified, the
CDA Viewer retains the formatting information stored in the document.
-w paper_width Specifies the paper width in units of characters. Each character unit translates to 720 centipoints (7200 centipoints
per inch or 10 characters per inch horizontally). The -w qualifier always specifies the fallback formatted document
page width to be used when the -r (override format) qualifier is specified or when the document has no inherent format.
If the -w qualifier is not specified and if the document has no inherent format, the default width is 85 characters,
which is equivalent to the default page width of 8.5 inches.
-h paper_height Specifies the paper height in units of characters. Each character unit translates to 1200 centipoints (7200 centipoints
per inch or 6 characters per inch vertically). The -h qualifier always specifies the fallback formatted document page
height to be used when the -r (override format) qualifier is specified or when the document has no inherent format. If
the -h qualifier is not specified and if the document has no inherent format, the default height is 66 lines, which is
equivalent to the default page height of 11 inches.
Command line parameters pertaining to XtInitialize() are also supported by dxvdoc (for example, -d node::0).
See Also
cdoc(1), vdoc(1), DDIF(5), DTIF(5), CDA(5), DOTS(5)
dxvdoc(1X)