dtifddif(1)dtifddif(1)Namedtifddif - convert DTIF formatted files to DDIF formatted files
Syntaxdtifddif [-m message_log] [-O optionfile] [-o outputfile] [-p
options_line]... [-d extension] [inputfile [outputfile [logfile]]]
Description
The dtifddif command reads a DTIF (table) formatted file from inputfile
and writes a DDIF formatted file to outputfile. Since this conversion
crosses from the DTIF grammar domain to DDIF, the converter is also
called a domain converter. To convert from file.dtif to file.ddif,
type:
dtifddif file.dtif file.ddif.
If you do not supply an input file, or if you supply a minus sign (-)
as an argument, dtifddif reads the DDIF file from the standard input
file. If you do not supply an output file, or if you supply a minus
sign (-) as an argument, dtifddif writes the DDIF file to the standard
output file.
If the DTIF input file is a newer version of the DTIF grammar than that
understood by the converter, data represented by the new grammar ele‐
ments is lost.
A document syntax error in the DTIF input file causes a fatal input
processing error. The conversion stops and no further input processing
occurs.
You can also invoke the dtifddif conversion with the cdoc(1) command
when you use that command and specify a source format (-s) in the DTIF
domain or a destination format (-d) in the DDIF domain.
Options-m message_log
Enables enhanced messaging and logs all messages to message_log
or, if '-' is specified, to standard error in place of the mes‐
sage_log. If you do not specify this option, only serious errors
are reported.
-O optionfile
Specifies the name of the options file containing options for this
converter.
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 let‐
ters, numbers, dollar signs, and underlines. The case of let‐
ters 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 speci‐
fied format.
To specify several options for the same input or output for‐
mat, 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 for‐
mats 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.
-o outputfile
Specifies the name of the output file. Included in the com‐
mand syntax for compatibility with the cdoc command.
-p options_line
Allows options to be specified on the command line and has
the same effect as specifying an options file for this con‐
verter. You can specify up to 100 options, each preceded by
-p.
-d extension
Allows the specification of a default file extension for com‐
patibility with other operating systems.
Converter Processing Options
When converting any table format to any document format, you can spec‐
ify the following domain converter processing options using a format
name of DTIF_TO_DDIF:
o COLUMN_TITLE
Displays the column title as contained in the column attributes,
centered at the top of the column.
o CURRENT_DATE
Displays the current date and time in the bottom left corner of
the page. The value is formatted according to the document's spec‐
ification for a default date and time.
o DOCUMENT_DATE
Displays the document date and time, as contained in the document
header, in the top left corner of the page. The value is formatted
according to the document's specification for a default date and
time.
o DOCUMENT_TITLE
Displays the document title or titles, as contained in the docu‐
ment header, centered at the top of the page, one string per line.
o PAGE_NUMBER
Displays the current page number in the top right corner of the
page.
o PAPER_SIZE size
Specifies the size of the paper to be used when formatting the
resulting DDIF output file. Valid values for the size argument are
as follows:
Keyword Meaning
A0 841 x 1189 millimeters (33.13 x 46.85 inches)
A1 594 x 841 millimeters (23.40 x 33.13 inches)
A2 420 x 594 millimeters (16.55 x 23.40 inches)
A3 297 x 420 millimeters (11.70 x 16.55 inches)
A4 210 x 297 millimeters (8.27 x 11.70 inches)
A5 148 x 210 millimeters (5.83 x 8.27 inches)
B4 250 x 353 millimeters (9.84 x 13.90 inches)
B5 176 x 250 millimeters (6.93 x 9.84 inches)
C4 229 x 324 millimeters (9.01 x 12.76 inches)
C5 162 x 229 millimeters (6.38 x 9.02 inches)
DL 110 x 220 millimeters (4.33 x 8.66 inches)
10x13_ENVELOPE 10 x 13 inches (254 x 330 millimeters)
9x12_ENVELOPE 9 x 12 inches (229 x 305 millimeters)
BUSINESS_ENVELOPE 4.13 x 9.5 inches (105 x 241 millimeters)
EXECUTIVE 7.5 x 10 inches (191 x 254 millimeters)
A 8.5 x 11 inches (216 x 279 millimeters)
B 11 x 17 inches (279 x 432 millimeters)
C 17 x 22 inches (432 x 559 millimeters)
D 22 x 34 inches (559 x 864 millimeters)
E 34 x 44 inches (864 x 1118 millimeters)
LEDGER 11 x 17 inches (279 x 432 millimeters)
LEGAL 8.5 x 14 inches (216 x 356 millimeters)
LETTER 8.5 x 11 inches (216 x 279 millimeters)
LP 13.7 x 11 inches (348 x 279 millimeters)
VT 8 x 5 inches (203 x 127 millimeters)
The A paper size (8.5 x 11 inches) is the default. You can specify the
following units of measurement: in for inches (default), cm for cen‐
timeters, mm for millimeters, po or pt for points.
o PAPER_HEIGHT height
Specifies a paper height other than one of the predefined values
provided. The default paper height is 11 inches. You can spec‐
ify the following units of measurement: in for inches (default),
cm for centimeters, mm for millimeters, po or pt for points.
o PAPER_WIDTH width
Specifies a paper width other than one of the predefined values
provided. The default paper width is 8.5 inches. You can spec‐
ify the following units of measurement: in for inches (default),
cm for centimeters, mm for millimeters, po or pt for points.
o PAPER_TOP_MARGIN top-margin
Specifies the height of the margin provided at the top of the
page. The default value is 0.25 inch. You can specify the fol‐
lowing units of measurement: in for inches (default), cm for
centimeters, mm for millimeters, po or pt for points.
o PAPER_BOTTOM_MARGIN bottom-margin
of the margin provided at the bottom of the page. The default
value is 0.25 inch. You can specify the following units of mea‐
surement: in for inches (default), cm for centimeters, mm for
millimeters, po or pt for points.
o PAPER_LEFT_MARGIN left-margin
Specifies the width of the margin provided on the left-hand side
of the page. The default value is 0.25 inch. You can specify
the following units of measurement: in for inches (default), cm
for centimeters, mm for millimeters, po or pt for points.
o PAPER_RIGHT_MARGIN right-margin
Specifies the width of the margin provided on the right-hand
side of the page. The default value is 0.25 inch. You can spec‐
ify the following units of measurement: in for inches (default),
cm for centimeters, mm for millimeters, po or pt for points.
o PAPER_ORIENTATION orientation
Specifies the paper orientation to be used in the output file.
The valid values for the orientation argument are:
Keyword Meaning
PORTRAIT The page is oriented so that the larger dimension is
parallel to the vertical axis.
LANDSCAPE The page is oriented so that the larger dimension is
parallel to the horizontal axis.
The default is PORTRAIT.
See Alsocdoc(1), dtifanls(1), CDA(5), cda_msg(5), DDIF(5), DTIF(5)dtifddif(1)
