ddiftext(1)ddiftext(1)Nameddiftext - convert DDIF formatted files to text formatted files
Syntaxddiftext [-m message_log] [-O optionfile] [-o outputfile] [-p
options_line]... [-d extension] [inputfile [outputfile [logfile]]]
Description
The ddiftext command reads a DDIF formatted file from inputfile and
writes a text file to outputfile. To convert from file.ddif to
file.text, type:
ddiftext file.ddif file.text.
If you do not supply an input file, or if you supply a minus sign (-)
as an argument, ddiftext 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, ddiftext writes the text file to the standard
output file.
You can also invoke the ddiftext conversion with the cdoc(1) command
when you use that command and specify the option -d text.
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.
All Latin1 text in the intermediate representation of the input file is
converted to the text output file. When converting an input file to a
text output file, you should be aware that text output files can con‐
tain only textual content and minimal formatting such as line feeds,
page breaks, and tabs. The Text back end converter preserves format‐
ting information to the extent possible. All graphics, images, and text
attributes in the intermediate representation of the input file are
lost when converted to the text output file.
A document syntax error in the DDIF input file causes a fatal input
processing error. The conversion stops and no further input processing
occurs.
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 that is included in the
command syntax for compatibility with the cdoc command.
-p options_line
Specifies command line options. This option has the same
effect as specifying an options file for this converter. You
can specify up to 100 options.
-d extension
Specifies a default file extension for compatibility with
other operating systems.
Converter Processing Optionsddiftext supports the following processing options in an options file
or in options specified on command lines:
o ASCII_FALLBACK [ON,OFF]
Causes text output in 7-bit ASCII. The fallback representation of
the characters is described in the ASCII standard. If this option
is not specified, the default is OFF; if this option is specified
without a value, the default is ON.
o CONTENT_MESSAGES [ON,OFF]
Causes the converter to put a message in the output file each time
a nontext element is encountered. If this option is not speci‐
fied, the default is OFF; if this option is specified without a
value, the default is ON.
o HEIGHT value
Specifies the maximum number of lines per page in your text output
file. If you specify zero, the number of lines per page will cor‐
respond to the height specified in your document. If you addition‐
ally specify OVERRIDE_FORMAT, or if the document has no inherent
page size, the document is formatted to the height value specified
by this option. The default height is 66 lines.
o OVERRIDE_FORMAT [ON,OFF]
Causes the converter to ignore the document formatting information
in the document, so that the text is formatted on a single large
paragraph per page. Specify the size of the page by the HEIGHT and
WIDTH processing options. If this option is not specified, the
default is OFF; if this option is specified without a value, the
default is ON.
o SOFT_DIRECTIVES [ON,OFF]
Causes the converter to obey the soft directives contained in the
document when creating the text output file. If this option is
not specified, the default is OFF; if this option is specified
without a value, the default is ON.
o WIDTH value
Specifies the maximum number of columns of characters per page in
the text output file. If you specify zero, the number of columns
per page will correspond to the width specified in your document.
If you additionally specify OVERRIDE_FORMAT, or if the document
has no inherent page size, the document is formatted to the value
specified by this processing option. If any lines of text exceed
this width value, the additional columns are truncated. The
default width is 80 characters.
See Alsocdoc(1), dtifddif(1), textddif(1), vdoc(1), CDA(5), cda_msg(5), DDIF(5)ddiftext(1)
