Technical Guide to the CDA Converter Library

*HyperReader

CONTENTS

  Title Page

  Copyright Page

  Preface

  1      Text Converters
    1.1 Alternate Format Syntax (AFS) Input Converter
      1.1.1      Missing Data and Format Information
      1.1.2      Data Mapping
      1.1.3      Tags
        1.1.3.1      Style Reference Tag
        1.1.3.2      Element Tags
        1.1.3.3      Element Tags with Local Attributes
        1.1.3.4      Markers
        1.1.3.5      Character Set Tags
        1.1.3.6      Flow Tags
        1.1.3.7      Tag Omission
      1.1.4      Entity References
        1.1.4.1      Internal Entity References
        1.1.4.2      External Entity References
      1.1.5      Processing Instructions
      1.1.6      External File References
        1.1.6.1      Creating and Editing AFS Documents
        1.1.6.2      Creating New AFS Documents
        1.1.6.3      Editing AFS Documents
        1.1.6.4      Editing Restrictions
        1.1.6.5      Editing AFS Documents Produced by DECwrite
    1.2 Alternate Format Syntax (AFS) Output Converter
      1.2.1      Missing Data and Format Information
      1.2.2      Data Mapping
        1.2.2.1      Document Segments
      1.2.3      Text Content
        1.2.3.1      Nontextual Segments
        1.2.3.2      DDIF Companion File
      1.2.4      External File References
      1.2.5      File Naming Conventions for Associated DDIF Files
    1.3 Document Content Architecture/Revisable Form Text (DCA/RFT) Input Converter
      1.3.1      Missing Data and Format Information
      1.3.2      External File References
        1.3.2.1      Document Structure
          1.3.2.1.1       Format Units
          1.3.2.1.2       Text Unit
          1.3.2.1.3       End Unit
        1.3.2.2      Document Layout
          1.3.2.2.1       Page Orientation
          1.3.2.2.2       Presentation Direction
          1.3.2.2.3       Page Parameters
      1.3.3      Data Mapping
        1.3.3.1      Document Characteristics
          1.3.3.1.1       Line Drawing Characters
          1.3.3.1.2       Document Parameters
          1.3.3.1.3       Punctuation Format
          1.3.3.1.4       Master Formats
          1.3.3.1.5       Page Image Parameters
          1.3.3.1.6       Line Parameters
          1.3.3.1.7       Tab Parameters
          1.3.3.1.8       Note Formatting Parameters
          1.3.3.1.9       Auto-Outline Parameters
          1.3.3.1.10      Margin Text
          1.3.3.1.11      Additional Parameters
        1.3.3.2      Text Unit
          1.3.3.2.1       Text Unit Format Change
          1.3.3.2.2       Return to Master Format
          1.3.3.2.3       Body Text
          1.3.3.2.4       Text Unit Prefix
        1.3.3.3      Single Byte Controls
        1.3.3.4      Multibyte Controls
        1.3.3.5      End Unit
    1.4 Document Content Architecture/Revisable Form Text (DCA/RFT) Output Converter
      1.4.1      Missing Data and Format Information
      1.4.2      Data Mapping
        1.4.2.1      Document Information
        1.4.2.2      Document Segments
        1.4.2.3      Text Content
        1.4.2.4      Directives
        1.4.2.5      Layout Galley
        1.4.2.6      Segment Attributes
        1.4.2.7      Wrap Attributes
        1.4.2.8      Layout Attributes
        1.4.2.9      Galley Attributes
        1.4.2.10     Page Layout
        1.4.2.11     Tab Stop
    1.5 Digital Standard Runoff (DSR) Input Converter
      1.5.1      Missing Data and Format Information
      1.5.2      Supported DSR Features
    1.6 Data Exchange (DX) Input Converter
      1.6.1      Missing Data and Format Information
      1.6.2      Data Mapping
        1.6.2.1      Header Data
        1.6.2.2      Special Characters
        1.6.2.3      Special Character Modes
        1.6.2.4      Special Function Modes
        1.6.2.5      Rulers
        1.6.2.6      Ruler Combinations
        1.6.2.7      Character Sets
        1.6.2.8      Control Block Keywords
    1.7 Data Exchange (DX) Output Converter
      1.7.1      Missing Data and Format Information
      1.7.2      Data Mapping
      1.7.3      External File References
    1.8 MacWrite Input Converter
      1.8.1      Missing Data and Format Information
    1.9 MacWrite Output Converter
      1.9.1      Missing Data and Format Information
    1.10 Microsoft Word for MS-DOS (WORD5) Input Converter
      1.10.1     Missing Data and Format Information
        1.10.1.1     Conversion Limitations When Importing to DECwrite
      1.10.2     Supported Microsoft Word Features
      1.10.3     Font Names
      1.10.4     Font Allocation of the Microsoft Word Printer Drivers
      1.10.5     Font Mapping File
      1.10.6     Determining Autolinespacing in Microsoft Word
      1.10.7     Tabulators
      1.10.8     Margins
      1.10.9     Repaginating Control Codes
      1.10.10    Hyphenation
      1.10.11    Language Definition of the Document
      1.10.12    Graphics
    1.11 Microsoft Word for MS-DOS (WORD5) Output Converter
      1.11.1     Missing Data and Format Information
      1.11.2     Supported DDIF Features
        1.11.2.1     Using Character Sets
        1.11.2.2     Font Names
        1.11.2.3     Tabulators
        1.11.2.4     Margins
        1.11.2.5     Repaginating Control Codes
        1.11.2.6     Hyphenation
    1.12 Rich Text Format (RTF) Input Converter
      1.12.1     Missing Data and Format Information
        1.12.1.1     Conversion Limitations When Importing to DECwrite
      1.12.2     Supported RTF Features
    1.13 Rich Text Format (RTF) Output Converter
      1.13.1     Missing Data and Format Information
      1.13.2     Supported DDIF Features
    1.14 ROFF Input Converter
      1.14.1     Processing Options and Options Files
        1.14.1.1     Mapping Tables
        1.14.1.2     Style Files
        1.14.1.3     Specifying Options in an Options File
      1.14.2     Missing Data and Format Information
      1.14.3     Creating Your Own Mapping Table
        1.14.3.1     Structure of a Mapping Table
      1.14.4     Mapping Commands
        1.14.4.1     Using Commands and Attributes
        1.14.4.2     Command Definitions
      1.14.5     Declaring Defaults and Defining Fonts
        1.14.5.1     Declaring Default Values
        1.14.5.2     Defining Fonts
      1.14.6     Mapping a ROFF Title
        1.14.6.1     DDIF Rules for Titles
          1.14.6.1.1      Contents of a DDIF Title
          1.14.6.1.2      Nesting Rules for the DDIF Titles
        1.14.6.2     Coding Guidelines
        1.14.6.3     Code Examples
          1.14.6.3.1      Mapping a Numbered Heading
          1.14.6.3.2      Mapping an Unnumbered Heading
      1.14.7     Mapping a ROFF List
        1.14.7.1     DDIF Rules for Lists
          1.14.7.1.1      Contents of a DDIF List
          1.14.7.1.2      Nesting Rules for the DDIF Lists
        1.14.7.2     Coding Guidelines
        1.14.7.3     Code Example
          1.14.7.3.1      Mapping a Bulleted List
          1.14.7.3.2      Mapping a Numbered List
          1.14.7.3.3      Mapping a List End
      1.14.8     Mapping a ROFF Paragraph
        1.14.8.1     DDIF Rules for Paragraphs
          1.14.8.1.1      Nesting Rules for the DDIF Paragraphs
        1.14.8.2     Coding Guidelines
        1.14.8.3     Code Example
          1.14.8.3.1      Mapping a Block Paragraph
          1.14.8.3.2      Mapping a Standard Indented Paragraph
          1.14.8.3.3      Mapping an Indented Paragraph with a Label
      1.14.9     Testing and Using the Mapping Table
        1.14.9.1     Testing the Mapping Table
        1.14.9.2     Correcting Errors
        1.14.9.3     Using the Mapping Table
      1.14.10    Mapping Table Commands and Syntax
        1.14.10.1    Mapping Table Grammar Rule Conventions
        1.14.10.2    Mapping Table Symbols and Definitions
        1.14.10.3    Structure of the Mapping Table Sections
          1.14.10.3.1     defaults
          1.14.10.3.2     font_list
          1.14.10.3.3     macro_list
          1.14.10.3.4     special_list
        1.14.10.4    Statements
          1.14.10.4.1     Conditional Statements
          1.14.10.4.2     Create Statements
          1.14.10.4.3     End Statements
          1.14.10.4.4     Style Statements
      1.14.11    Converter Support for Raw ROFF
      1.14.12    Converter Support for Escape Sequences
      1.14.13    Converter Support for Macro Commands
        1.14.13.1    Mapping Special Characters and Greek Characters
      1.14.14    Sample Mapping Tables for the Macro Packages
    1.15 Standard Generalized Markup Language (SGML) Input Converter
      1.15.1     Missing Data and Format Information
      1.15.2     Elements and Tags
      1.15.3     SGML Declaration
      1.15.4     Notations
      1.15.5     Entities
        1.15.5.1     Internal Entity
        1.15.5.2     External Entity References
      1.15.6     Processing Instructions
      1.15.7     Document Type Definitions
        1.15.7.1     Using the ANY Keyword
      1.15.8     SGML Subdocuments
      1.15.9     Sample SGML Document
      1.15.10    Data Mapping
      1.15.11    External File References
      1.15.12    Converting SGML Documents to DECwrite
      1.15.13    Converting SGML Documents Created by DECwrite
      1.15.14    Converting SGML Documents not Created by DECwrite
    1.16 Standard Generalized Markup Language (SGML) Output Converter
      1.16.1     Missing Data and Format Information
      1.16.2     Data Mapping
        1.16.2.1     Converting Structured Documents
        1.16.2.2     Converting Unstructured Documents
      1.16.3     External File References
      1.16.4     Converting DECwrite Documents to SGML
    1.17 WordPerfect (WORDP) Input Converter
      1.17.1     Missing Data and Format Information
      1.17.2     Supported WordPerfect Features
    1.18 WordPerfect (WORDP) Output Converter
      1.18.1     Missing Data and Format Information
      1.18.2     Supported DDIF Features
    1.19 WPS-PLUS (WPL) Input Converter
      1.19.1     Supported Features
      1.19.2     Missing Data and Format Information
    1.20 WPS-PLUS (WPL) Output Converter
      1.20.1     Supported Features
      1.20.2     Missing Data and Format Information

  2      Table Converters
    2.1 ASCII Field Input Converter
      2.1.1      Missing Data and Format Information
    2.2 ASCII Tabular Input Converter
      2.2.1      Missing Data and Format Information
    2.3 ASCII Tabular Output Converter
      2.3.1      Missing Data and Format Information
    2.4 DECcalc (CALCGRD) Input Converter
      2.4.1      Missing Data and Format Information
    2.5 Data Interchange Format (DIF) Input Converter
      2.5.1      Missing Data and Format Information
    2.6 Lotus 1-2-3 V2. * (WK1) Input Converter
      2.6.1      Missing Data and Format Information
    2.7 Lotus 1-2-3 V2. * (WK1) Output Converter
      2.7.1      Missing Data and Format Information
    2.8 Lotus 1-2-3 V3. * (WK3) Input Converter
      2.8.1      Missing Data and Format Information
    2.9 Lotus 1-2-3 V3. * (WK3) Output Converter
      2.9.1      Missing Data and Format Information

  3      Image and Graphics Converters
    3.1 Computer Graphics Metafile (CGM) Input Converter
      3.1.1      Missing Data and Format Information
      3.1.2      Data Mapping
        3.1.2.1      Delimiter Elements
        3.1.2.2      Metafile Descriptor Elements
        3.1.2.3      Picture Descriptor Elements
        3.1.2.4      Control Elements
        3.1.2.5      Graphical Primitive Elements
        3.1.2.6      Attribute Elements
        3.1.2.7      Escape Elements
        3.1.2.8      External Elements
    3.2 Computer Graphics Metafile (CGM) Output Converter
      3.2.1      Missing Data and Format Information
      3.2.2      Data Mapping
        3.2.2.1      Delimiter Elements
        3.2.2.2      Metafile Descriptor Elements
        3.2.2.3      Picture Descriptor Elements
        3.2.2.4      Control Elements
        3.2.2.5      Graphical Primitive Elements
        3.2.2.6      Attribute Elements
        3.2.2.7      Escape Elements
        3.2.2.8      External Elements
    3.3 Graphics Hardcopy Format (GRAPHICS) Output Converter
      3.3.1      Missing Data and Format Information
      3.3.2      Data Mapping
    3.4 Graphics Interchange Format (GIF) Input Converter
      3.4.1      Supported Features
      3.4.2      Missing Data and Format Information
    3.5 MacPaint Input Converter
      3.5.1      Supported File Formats
      3.5.2      Missing Data and Format Information
      3.5.3      Data Mapping
    3.6 MacPaint Output Converter
      3.6.1      Supported Features
      3.6.2      Missing Data and Format Information
      3.6.3      Data Mapping
    3.7 MacDraw Image and Graphics Format (PICT) Input Converter
      3.7.1      Missing Data and Format Information
    3.8 MacDraw Image and Graphics Format (PICT) Output Converter
      3.8.1      Missing Data and Format Information
    3.9 Tagged Image File Format (TIFF) Input Converter
      3.9.1      Missing Data and Format Information
      3.9.2      Data Mapping
    3.10 Tagged Image File Format (TIFF) Output Converter
      3.10.1     Missing Data and Format Information
      3.10.2     Data Mapping