dtifddif(1)
Name
dtifddif − convert DTIF formatted files to DDIF formatted files
Syntax
dtifddif [−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 elements 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 message_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 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.
−o outputfile
Specifies the name of the output file. Included in the command 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 converter. You can specify up to 100 options, each preceded by -p.
−d extension
Allows the specification of a default file extension for compatibility with other operating systems.
Converter Processing Options
When converting any table format to any document format, you can specify 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 specification 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 document 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:
KeywordMeaning
A0841 x 1189 millimeters (33.13 x 46.85 inches)
A1594 x 841 millimeters (23.40 x 33.13 inches)
A2420 x 594 millimeters (16.55 x 23.40 inches)
A3297 x 420 millimeters (11.70 x 16.55 inches)
A4210 x 297 millimeters (8.27 x 11.70 inches)
A5148 x 210 millimeters (5.83 x 8.27 inches)
B4250 x 353 millimeters (9.84 x 13.90 inches)
B5176 x 250 millimeters (6.93 x 9.84 inches)
C4229 x 324 millimeters (9.01 x 12.76 inches)
C5162 x 229 millimeters (6.38 x 9.02 inches)
DL110 x 220 millimeters (4.33 x 8.66 inches)
10x13_ENVELOPE10 x 13 inches (254 x 330 millimeters)
9x12_ENVELOPE9 x 12 inches (229 x 305 millimeters)
BUSINESS_ENVELOPE
4.13 x 9.5 inches (105 x 241 millimeters)
EXECUTIVE7.5 x 10 inches (191 x 254 millimeters)
A8.5 x 11 inches (216 x 279 millimeters)
B11 x 17 inches (279 x 432 millimeters)
C17 x 22 inches (432 x 559 millimeters)
D22 x 34 inches (559 x 864 millimeters)
E34 x 44 inches (864 x 1118 millimeters)
LEDGER11 x 17 inches (279 x 432 millimeters)
LEGAL8.5 x 14 inches (216 x 356 millimeters)
LETTER8.5 x 11 inches (216 x 279 millimeters)
LP13.7 x 11 inches (348 x 279 millimeters)
VT8 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 centimeters, 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 specify 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 specify 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 following 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 measurement: 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 specify 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:
KeywordMeaning
PORTRAITThe 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.