textddif(1) — Commands
Name
textddif − convert text formatted files to DDIF formatted files
Syntax
textddif [−m message_log] [−O optionfile] [−o outputfile] [−p options_line]... [−d extension] [inputfile [outputfile [logfile]]]
Description
The textddif command reads a text formatted file from inputfile and writes a DDIF file to outputfile. To convert from file.text to file.ddif type:
textddif file.text file.ddif.
If you do not supply an input file, or if you supply a minus sign (−) as an argument, textddif reads the text file from standard input. If you do not supply an output file, or if a minus sign (−) is encountered as an argument, textddif writes the DDIF file to standard output.
You can also invoke the textddif conversion with the cdoc(1) command when you use that command and specify the option −s text.
The textddif command maps line breaks and form feeds to DDIF directives. One or more contiguous blank lines are interpreted as end-of-paragraph markers. The text input file does not lose any information because no structure information is contained in a text file. The information in the intermediate representation of the input file maps directly to the DDIF output file.
The textddif command converts all nonprinting characters to space characters. For example, characters introducing ANSI escape characters are converted to space characters. There is no attempt to interpret ANSI escape sequences.
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 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. There are currently no options for this converter.
−o outputfile
Specifies the name of the output file. Included in the command syntax for compatibility with the cdoc command.
−p options_line
Allows you to specify options on command line. Has the same effect as specifying an options file for this converter. You can specify up to 100 options.
−d extension
Allows the specification of a default file extension for compatibility with other operating systems.