Manual Page Result
0
Command: ddifps | Section: 1 | Source: Digital UNIX | File: ddifps.1.gz
ddifps(1) General Commands Manual ddifps(1)
NAME
ddifps - convert DDIF formatted files to PostScript(TM) formatted files
SYNOPSIS
ddifps [-m message_log] [-O optionfile] [-o outputfile] [-p op-
tions_line]... [-d extension] [inputfile [outputfile [logfile]]]
OPTIONS
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.
Specifies the name of the options file that contains the options you
want to select for this converter.
The options file has a default file type of Each line of the op-
tions file specifies a format name that can optionally be fol-
lowed 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 op-
tions 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. Specifies
the name of the output file that is included in the command syn-
tax for compatibility with the cdoc command. 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. Allows the specifica-
tion of a default output file extension for compatibility with
other operating systems.
DESCRIPTION
The ddifps command reads a DDIF formatted file from inputfile and
writes a PostScript file to outputfile. To convert from file.ddif to
file.ps, type:
ddifps file.ddif file.ps
If you do not supply an input file, or if you supply a minus sign (-)
as an argument, ddifps reads the DDIF file from the standard input
file. If you do not supply an output file, or if a minus sign (-) is
encountered as an argument, ddifps writes the PostScript file to the
standard output file.
If you specify a logfile, ddifps redirects the standard error to the
logfile. You can also invoke the ddifps conversion with the cdoc com-
mand when you use that command and specify the option -d ps.
If the DDIF input file is a newer version of the DDIF grammar than that
understood by the converter, data represented by the new grammar ele-
ments is lost. Any external file references within the DDIF input file
are resolved.
A document syntax error in the DDIF input file causes a fatal input
processing error. The conversion stops and no further input processing
occurs.
CONVERTER PROCESSING OPTIONS
The ddifps command supports the following processing options in an op-
tions file or in options specified on command lines: Specifies the size
of the paper to be used when formatting the resulting PostScript output
file. Valid values for the size argument are as follows:
l l. 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) A 8.5 x 11 inches (216 x 279 millime-
ters) 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 spec-
ify the following units of measurement: in for inches (default),
cm for centimeters, mm for millimeters, po or pt for points.
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. Spec-
ifies a paper width other than one of the predefined values pro-
vided. 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. Spec-
ifies 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 centime-
ters, mm for millimeters, po or pt for points. Specifies the
height of the margin provided at the bottom of the page. The de-
fault 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. 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 mea-
surement: in for inches (default), cm for centimeters, mm for
millimeters, po or pt for points. 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 mea-
surement: in for inches (default), cm for centimeters, mm for
millimeters, po or pt for points. Specifies the paper orienta-
tion to be used in the PostScript output file. You can specify
the following units of measurement: in for inches (default), cm
for centimeters, mm for millimeters, po or pt for points. The
valid values for the orientation argument are:
l lw(4.9i). Keyword Meaning PORTRAIT T{ The page is oriented
so that the larger dimension is parallel to the vertical axis.
T} LANDSCAPE T{ The page is oriented so that the larger dimen-
sion is parallel to the horizontal axis. T}
The default is PORTRAIT. Specifies whether the converter should
use 8-bit output. The default value is ON. Specifies whether
the converter processes the layout specified in the DDIF docu-
ment. The default value is ON. Specifies the size of the output
buffer. The value you specify must be within the range 64 to
256. The default value is 132. Specifies whether the converter
performs page wrapping of any text that would exceed the bottom
margin. The default value is ON. Specifies whether the con-
verter processes soft directives in the DDIF file in order to
format output. (Soft directives specify such formatting commands
as new line, new page, and tab.) If the converter processes soft
directives, the output file will look more like you intended it
to look. The default value is ON. Specifies whether the con-
verter performs word wrapping of any text that would exceed the
right margin. The default value is ON. If you specify OFF, the
converter allows text to exceed the right margin.
SEE ALSO
cdoc(1), cda(4), cda_msg(4), ddif(4), dvr_msg(4)
ddifps(1)