Digital

NAME

ddiftext − convert DDIF formatted files to text formatted files

SYNOPSIS

ddiftext [−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 or −s ddif. 

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. 
 

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 you do not specify this option and you do specify inputfile, outputfile, and logfile, 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 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
Specifys a default file extension for compatibility with other operating systems.
 

Converter Processing Options

ddiftext 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 specified, 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 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.

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.

RELATED INFORMATION

cdoc(1), ddifanls(1), ddifps(1), dtifanls(1), dtifddif(1), textddif(1)