Digital

NAME

ddifanls − convert DDIF formatted files to CDA Analysis formatted files

SYNOPSIS

ddifanls [−m message_log] [−O optionfile] [−o outputfile] [−p options_line]... [−d extension] [inputfile [outputfile [logfile]]]

DESCRIPTION

The ddifanls command reads a DDIF formatted file from inputfile and writes a CDA Analysis file to outputfile. To convert from file.ddif to file.cda_analysis type:

ddifanls file.ddif file.cda_analysis

If you do not supply an input file, or if you use a minus sign (−) as an argument, ddifanls reads the DDIF file from the standard input file.  If you do not supply an output file, or if you use a minus sign (−) as an argument, ddifanls writes the CDA Analysis file to the standard output file. 
 
The ddifanls conversion also invoked by the cdoc(1) command when you use that command and specify the option −d analysis 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. 

A document syntax error in the DDIF input file causes a fatal input processing error. The conversion stops and no further input processing occurs. 

Application end users use an analysis output file to determine whether an input file contains references of links to multiple "subfiles." You must copy each subfile separately across a network because subfiles are not automatically included when an input file is transferred across a network. 

FLAGS

−m message_log
Logs messages to the specified file. If you use a minus sign (−) as an argument, this option logs messages to the standard error file. If you do not specify this option, but you do specify inputfile, outputfile, and logfile, then message_log will contain only 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. Included in the command syntax for compatibility with the cdoc command. 

−p options_line
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.

−d extension
Allows the specification of a default file extension for compatibility with other operating systems.

Converter Processing Options

When using the ddifanls converter you can produce an analysis of the CDA in-memory structure in the form of text output showing the named objects and values stored in the document. This is useful for debugging DDIF application programs. You can specify the following converter options:

o INHERITANCE
Specifies that the analysis is shown with attribute inheritance enabled. Inherited attributes are marked by "[inherited value]" in the output.

o TRANSLATE_BYTE_STRINGS
Overrides the default. For data of type BYTE STRING, the Analysis output does not display the hexadecimal translation if all the characters in the byte string are printable characters (hex values 20 through 7E). To override this option, supply the TRANSLATE_BYTE_STRINGS option.

o IMAGE_DATA
Overrides the default. For the special case of byte string data for item DDIF$_IDU_PLANE_DATA (a bitmapped image), the following comment appears on the display:

! ∗∗∗ Bit-mapped data not displayed here ∗∗∗

To retain the hexadecimal display, supply the IMAGE_DATA option.  There is no translation into ASCII. 

RELATED INFORMATION

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