 |
Index for Section 1 |
|
 |
Alphabetical listing for D |
|
dtifddif(1)
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]]]
OPTIONS
-m message_log
Enables enhanced messaging and logs all messages to message_log or, if
`-' is specified, to the 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 the 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.
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.
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:
COLUMN_TITLE
Displays the column title as contained in the column attributes,
centered at the top of the column.
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.
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.
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.
PAGE_NUMBER
Displays the current page number in the top right corner of the page.
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
centimeters, mm for millimeters, po or pt for points.
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.
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.
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.
PAPER_BOTTOM_MARGIN bottom-margin
Specifies the height 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.
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.
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.
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 ALSO
cdoc(1), dtifanls(1), cda(4), cda_msg(4), ddif(4), dtif(4)