Content-type: text/html
ddiftext - convert DDIF formatted files to text formatted files
ddiftext [-m message_log] [-O optionfile] [-o outputfile] [-p options_line]... [-d extension] [inputfile [outputfile [logfile]]]
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 containing options for this converter.
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 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 elements 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 contain only textual content and minimal formatting such as line feeds, page breaks, and tabs. The Text back end converter preserves formatting 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.
ddiftext
supports the following processing options
in an options file or in options specified on command lines:
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.
Causes the converter to put a message in the output file each
time a nontext element is encountered. If this option is not specified, the
default is OFF; if this option is specified without a value, the default is
ON.
Specifies the maximum number of lines per page in your text
output file. If you specify zero, the number of lines per page will correspond
to the height 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 height value specified by this option.
The default height is 66 lines.
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.
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.
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.
cdoc(1), dtifddif(1), textddif(1), vdoc(1), cda(4), cda_msg(4), ddif(4)