Contents

• Contents
  • 1. Introduction
    • 1.1 About TkSGML
    • 1.2 How is this manual organised
      • 1.2.1 Notational conventions
  • 2. Walk-through example
• I. Using TkSGML
  • 3. TkSGML Usage
    • 3.1 Loading TkSGML
      • 3.1.1 Loading TkSGML using the package system
      • 3.1.2 Loading TkSGML using the load command
      • 3.1.3 The activation key
      • 3.1.4 Details about the load process
    • 3.2 Creating a Widget
  • 4. Widget Contents
    • 4.1 Text
      • 4.1.1 Text properties
    • 4.2 Markup
      • 4.2.1 Elements
      • 4.2.2 Entities
      • 4.2.3 Marked Sections
      • 4.2.4 Comments
      • 4.2.5 Processing Instructions
    • 4.3 Annotations
      • 4.3.1 Marks
      • 4.3.2 Tags
      • 4.3.3 Windows
      • 4.3.4 Images
• II. Widget Commands
  • 5. Widget commands overview
    • 5.1 Specifying arguments for widget commands
      • 5.1.1 Boolean values
      • 5.1.2 Indices
      • 5.1.3 Colors
      • 5.1.4 Fonts
      • 5.1.5 Screen distances
      • 5.1.6 Bitmaps
      • 5.1.7 Reliefs
      • 5.1.8 Handles
  • 6. Configuring the widget
    • 6.1 Configuration options
      • 6.1.1 Standard options
      • 6.1.2 Widget-specific options
    • 6.2 Using the option database
  • 7. Loading, saving, and creating new documents
    • 7.1 Loading documents
    • 7.2 Saving documents
    • 7.3 Creating new documents
      • 7.3.1 Creating new SGML documents
      • 7.3.2 Creating new XML documents
  • 8. Text modification commands
    • 8.1 Insert
    • 8.2 Delete
    • 8.3 Get and Iget
    • 8.4 Search
    • 8.5 Dump and Edump
  • 9. Annotation commands
    • 9.1 Marks
    • 9.2 Tags
      • 9.2.1 Tag configuration options
      • 9.2.2 Tag bindings
    • 9.3 Windows
      • 9.3.1 Configuration options for embedded windows
    • 9.4 Images
      • 9.4.1 Image configuration options
  • 10. Index commands
    • 10.1 Normalizing indices
    • 10.2 Comparing indices
    • 10.3 Adjusting index ranges
    • 10.4 Mapping to and from external locations
  • 11. Elements
    • 11.1 Element names and element handles
      • 11.1.1 Element names
      • 11.1.2 Element handles
    • 11.2 The element widget command
      • 11.2.1 Using the element command
    • 11.3 Configuring elements
      • 11.3.1 Element configuration options
  • 12. Attributes
    • 12.1 Accessing the attribute list
    • 12.2 Specifying which attributes are shown
    • 12.3 Attributes with list values
    • 12.4 Attributes with ID and IDREF values
  • 13. Entities
    • 13.1 Inserting entities
    • 13.2 Modifying the display
      • 13.2.1 XML and Entities
    • 13.3 Defining new entities
      • 13.3.1 Removing entity definitions
    • 13.4 The character map
      • 13.4.1 Character to Entity Mapping
      • 13.4.2 Construction of the entity map
    • 13.5 Text entities
      • 13.5.1 Inserting text entities
      • 13.5.2 Unlocking of text entities
    • 13.6 Parameter entities
    • 13.7 Configuring entities
    • 13.8 Notations
  • 14. Marked Sections
    • 14.1 Inserting marked sections
    • 14.2 Indices for marked sections
    • 14.3 Deleting marked sections
    • 14.4 Marked section status
  • 15. Comments
    • 15.1 Inserting comments
    • 15.2 Getting a comment handle
    • 15.3 Modifying comments
    • 15.4 Deleting comments
  • 16. Processing Instructions
    • 16.1 Inserting PIs
    • 16.2 Retrieving a PI handle
    • 16.3 Modifying PIs
    • 16.4 Deleting PIs
  • 17. DTD related commands
    • 17.1 Retrieving the DTD name
    • 17.2 Getting an identification
  • 18. Document related commands
    • 18.1 Validating the document
    • 18.2 Document element
    • 18.3 Document prolog
    • 18.4 Statistics
  • 19. XML support
    • 19.1 Differences between SGML and XML mode
    • 19.2 DTDless and valid XML documents
      • 19.2.1 Additional commands for XML documents
  • 20. Notifications
  • 21. Undoing operations
    • 21.1 Reverting the last operation
    • 21.2 Grouping undo information
  • 22. Display commands
    • 22.1 Screen locations
    • 22.2 Adjusting the display
    • 22.3 Turning tags off
  • 23. Slave widgets
    • 23.1 Configuring slave widgets
    • 23.2 Widget commands for slave widgets
• III. System Integration
  • 24. Catalogs and System identifiers
    • 24.1 Catalog files
    • 24.2 System identifiers
      • 24.2.1 Formal system identifiers
      • 24.2.2 Simple system identfiers
      • 24.2.3 Encodings
    • 24.3 User defined storage managers
  • 25. TkSGML System integration
    • 25.1 TkSGML System components
    • 25.2 Environment variables
    • 25.3 System declaration
    • 25.4 Default SGML declaration
    • 25.5 Default XML declaration
  • 26. Bindings
    • 26.1 Default Bindings
• IV. Appendix
  • 27. Troubleshooting
• Bibliography
• Index