DECdocument
Producing Online and
Printed Documentation

Contents

Part 1
Part 1	Writing a Document
Chapter 1
1	Introduction to DECdocument
1.1	Writing Books for Both Printed and Bookreader Display
1.1.1	Topics and Online Chunks
1.1.2	Graphics Concepts
1.2	Using the DOCUMENT Command Line
Chapter 2
2	Getting Started with DECdocument
2.1	Global Tags and Doctype-Specific Tags
2.2	Tags and Tag Arguments
2.3	Basic Text Elements
2.3.1	Chapters
2.3.2	Headings and Subheadings
2.3.3	Paragraphs
2.3.4	Lists
2.4	Controlling the Output of a Document
2.4.1	Starting New Pages
2.4.2	Starting New Lines
2.4.3	Keeping a Text String on One Line
2.4.4	Specifying Final Formatting
2.5	Other Features
2.5.1	Emphasizing Words and Phrases
2.5.2	Using Footnotes in Text, Headings, and Tables
2.5.2.1	Using Footnotes in Text
2.5.2.2	Using Footnotes in Headings
2.5.2.3	Using Footnotes in Tables
2.5.3	Using Change Bars
2.5.4	Coding Hyphens and Dashes in Text
2.5.5	Dividing a Document into Separate Parts
2.6	Considerations for Bookreader Display
2.6.1	Dividing Long Sections or Examples into Online Chunks
2.6.2	Setting Online Topic Levels
2.6.2.1	Controlling the Topic Level Bookreader Displays
2.6.2.2	Specifying the Online Topic Level within a File
2.6.3	Changing Topic Labels
2.6.4	Creating Online Popups
Chapter 3
3	Creating Tables, Figures, and Examples
3.1	Tables
3.1.1	Making Tables Formal or Informal
3.1.2	Dividing a Table into Units
3.1.3	Coding a Table with a Key
3.1.4	Setting up Nested Tables
3.1.5	Controlling Table Attributes
3.1.5.1	Controlling the Width and Size of Table Text
3.1.5.2	Controlling Page Breaks in Tables
3.1.6	Additional Table Tags
3.2	Figures
3.2.1	The DECdocument Graphics Editor
3.2.2	Making Figures Formal or Informal
3.2.3	Figure Elements
3.2.4	Controlling Figure Attributes
3.2.4.1	Controlling Figure Margins
3.2.4.2	Controlling Page Breaks in Figures
3.2.5	Including Graphics Files
3.3	Examples
3.3.1	Making Examples Informal
3.3.2	Making Examples Formal
3.4	Considerations for Bookreader Display
3.4.1	Preparing Informal Tables, Figures, and Examples for Bookreader Display
3.4.2	Preparing Formal Tables, Figures, and Examples for Bookreader Display
Chapter 4
4	Providing Cross-References and Symbol Names
4.1	When to Use Symbol Names to Cross Reference
4.2	Creating Symbol Names
4.3	Referring to Symbol Names
4.4	Storing Symbol Names in Separate Files
4.5	Storing Symbol Names in a Cross-Reference File
4.6	Creating Hotspots for Any Piece of Text
4.7	Automatically Generating Symbol Names
Chapter 5
5	Creating an Index
5.1	Index Entries in Printed and Bookreader Books
5.2	Using Tags to Create an Index
5.3	Correct Placement of Index Tags
5.3.1	Using Index Tags in Text
5.3.2	Using Index Tags in Tables
5.3.3	Using Index Tags in Figures and Examples
5.4	Controlling Index Attributes
5.5	Specifying Individual and Master Index Entries
Chapter 6
6	Creating Front Matter
6.1	Front Matter Tags
6.2	Front Matter Components
6.2.1	Title Page
6.2.2	Copyright Page
6.2.3	Table of Contents
6.2.4	Preface
6.2.4.1	Specifying a Beginning Preface Page Number for a Printed Book
6.3	Bookreader Formatting Tags for the License Management Facility (LMF)
6.3.1	Using the <LMF> Tags
6.3.2	Sample Front Matter File
Chapter 7
7	Creating an Appendix and a Glossary
7.1	Creating an Appendix
7.2	Creating a Glossary
7.3	Displaying Glossary Entries in an Online Table of Contents