dtifddif(1) — Commands
Digital
NAME
dtifddif − convert DTIF formatted files to DDIF formatted files
SYNOPSIS
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 the 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.
FLAGS
−m message_log
Logs messages to the specified file or, if a minus sign (−) is encountered as an argument, to the standard error file.
If this option is not specified and inputfile, outputfile, and logfile are specified, then the logfile will only contain serious errors.
−O optionfile
Specifies the name of the options file containing options for this converter.
−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.
−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:
| Keyword | Size |
| 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 | 13 x 254 millimeters (15.600 x 10 inches)) |
| 9x12_ENVELOPE | 12 x 229 millimeters (14.400 x 9 inches)) |
| BUSINESS_ENVELOPE | 9.5 x 105 millimeters (11.400 x 4.13 inches)) |
| EXECUTIVE | 10 x 191 millimeters (12.000 x 7.5 inches)) |
| A | 8.5 x 11 inches |
| B | 11 x 17 inches |
| C | 17 x 22 inches |
| D | 22 x 34 inches |
| E | 34 x 44 inches |
| LEDGER | 11 x 17 inches |
| LEGAL | 8.5 x 14 inches |
| LETTER | 8.5 x 11 inches |
| LP | 13.7 x 11 inches |
| VT | 8 x 5 inches |
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. @A0@841 x 1189 millimeters (33.13 x 46.85 inches)
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 height 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:
| 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.
RELATED INFORMATION
cdoc(1), ddifanls(1), ddifps(1), ddiftext(1), dtifanls(1), textddif(1)