Index for Section 1

Alphabetical listing for D

ddifanls(1)
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]]]

OPTIONS
  -m message_log
      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.

  -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 letters, numbers, dollar signs, and underlines. The case of
      letters 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 specified format.

      To specify several options for the same input or output format, 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 formats required when specifying options.

      By default, any messages that occur during processing of the options
      file are written to the 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. Included in the command syntax
      for compatibility with the 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, each preceded by -p.

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

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. If
  you specify a log file, ddifanls redirects the standard error to the log
  file. The ddifanls conversion is also invoked by the cdoc command when you
  use that command and specify the option -d analysis or -d anls.

  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,
  unless the input file is transferred using DOTS. Search the analysis output
  file for all occurrences of the string "ERF_LABEL," followed by the subfile
  name in double quotes (") to determine whether a document has links to
  other files.

CONVERTER PROCESSING OPTIONS
  When using the 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:

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

  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.

  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.






SEE ALSO
  cdoc(1), ctod(1), dtifanls(1), dtoc(1), cda(4), cda_msg(4), ddif(4),
  dots(4), dtif(4)