 |
Click this button to go to the index for this section. |
cdoc(1)
NAME
cdoc - invokes CDA document conversion
SYNOPSIS
cdoc [-s format] [-d format] [-O options_file] [-m message_log] [-o
outputfile] inputfile
OPTIONS
-s format
Specifies the format of inputfile and invokes an appropriate input
converter as part of CDA. The DDIF, DTIF, DOTS (for Analysis output
only) and Text converter are provided in the DEC CDA Run-Time Services
kit. Additional converters can be added by other layered products.
Contact your system manager for a complete list of the input formats
supported on your system. The default format is DDIF.
-d format
Specifies the format of outputfile and invokes an appropriate output
converter as part of CDA. The DDIF, DTIF, Text, Analysis, and PS
converters are provided in the DIGITAL UNIX OSFCDABASE subset or the
DEC CDA Run-Time Services kit. Additional converters can be added by
other layered products. Contact your system manager for a complete list
of the output formats supported on your system. The default format is
DDIF.
-O options_file
Names the file passed to the input and output converters to control
specific processing options for each 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 an input
or output converter. The second word is a valid option preceded by one
or more spaces, tabs, or a slash (/) and can contain uppercase and
lowercase letters, numbers, 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.
You can precede any line by spaces and tabs. To terminate a line, use
any character other than those 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 end
converters 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 standard error. For those input and output formats
that support a LOG option, messages can be directed to a log file or to
a common message log.
-m message_log
Enables enhanced messaging and logs all messages to message_log or, if
`-' is specified, to standard error in place of the message_log. If you
do not specify this option, only serious errors are reported.
Once you create the common message log, CDA access routine users can
manage their front and back end messages by continuing to direct those
messages to the common message log. When you create a common message
log, error messages may still be sent to individual front and back end
logs through the use of the options for those front and back ends. The
common message log serves as a convenient tool for integration of
messages from the various front and back ends.
-o outputfile
Specifies the name of the output file. If not specified, cdoc writes to
standard output.
DESCRIPTION
The cdoc command converts the revisable format file, inputfile, to another
revisable format or to a final form file. If inputfile is not specified,
cdoc reads from standard input. Unless a destination file is specified with
the -o option, the cdoc command writes files to standard output.
SEE ALSO
ctod(1), ddifanls(1), ddifps(1), ddiftext(1), dtifanls(1), dtifddif(1),
dtoc(1), dxvdoc(1X), textddif(1), vdoc(1), cda(4), cda_msg(4), ddif(4),
ddis(4), dots(4), dtif(4), dvr_msg(4)