HP OpenVMS Systems Documentation

The following table describes commands and keys that can be used to process EDT commands:

The following table describes miscellaneous commands and keys available in EDT:

DIGITAL Standard Runoff (DSR) is a text-formatting facility. This chapter describes:

• Entering DSR commands
• Invoking DSR
• Creating tables of contents
• Creating indexes
• Summary of DSR commands

For additional information about DSR, refer to the OpenVMS DIGITAL Standard Runoff Reference Manual or DCL Help for a complete description of the RUNOFF commands and qualifiers. Please note that the OpenVMS DIGITAL Standard Runoff Reference Manual is archived and no longer available with the OpenVMS Documentation set. This manual has been included in Bookreader and PostScript format on the OpenVMS Version 7.2 Documentation CD.

10.1 About DSR

By inserting DSR commands, control characters, and other special identifiers within a text file, you can use DSR to:

• Determine the size of pages
• Create uneven or justified right margins
• Place space between lines
• Form lists
• Create title pages, footnotes, tables of contents, indexes, and appendixes

The steps for formatting a file with DSR are as follows:

To enter a DSR command, create the source file with EDT, EVE, or another text editor. Begin the command in column 1 of a line and precede the command with a period. Most DSR commands have standard abbreviations. For example, you can abbreviate the .NO CONTROL CHARACTERS command as .NCC.

The following example shows how to insert a blank line between two lines of text:

We sail the ocean blue,
.BLANK
And our saucy ship's a beauty.

After you add DSR commands to your file and exit from the editor, you are ready to process the file with DSR. To invoke DSR, enter the RUNOFF command followed by the name of the file you want to process.

If you process a file with the file type .RNO, you need only to enter the file name, not the file type. By default, the RUNOFF command produces an output file with the same file name as the input file and the file type .MEM.

Both of the following examples produce output files named FUN.MEM.

• In the following example, a file named FUN.RNO is processed:

  $ RUNOFF FUN

• In the following example, a file named FUN.FUN is processed (both the file name and the file type are specified):

  $ RUNOFF FUN.FUN

By using qualifiers with the RUNOFF command, you can override DSR commands or flags included in your text file. RUNOFF command qualifiers allow you to alter the position of the text on all pages of the document, to specify emphasis such as underlining and bolding, and to otherwise control the appearance of printed output.

In the following example, the /NOBOLD qualifier suppresses any bolding specified in the file by using the DSR command .FLAGS BOLD:

$ RUNOFF/NOBOLD FUN

Table 10-1 summarizes the RUNOFF command qualifiers.

When you use DSR to process a file, your output file looks different from your input file because DSR provides the following standard format default settings:

• A standard typewriter page size of 8 1/2 x 11 inches; that is, a width of 70 character positions and a length of 58 lines of text per page (.PAGE SIZE 58,70)
• Sequential page numbering for every page but the first (.PAGING)
• A left margin setting of 0 (just before the first character position of a line) and a right margin setting of 70 (just after the 70th character position of a line) (.LEFT MARGIN 0 and .RIGHT MARGIN 70)
• Line spacing equivalent to the single-space setting on a typewriter (.SPACING 1)
• A tab setting every eighth character position on a line (.TAB STOPS 8, 16, 24, ...)
• Filling: DSR fills each line with as many words as possible until the addition of another complete word would exceed the right margin (.FILL)
• Justification: DSR adds spaces between words to expand each line exactly to the right margin, making the right margin even or justified (.JUSTIFY)

If you do not want your file to be formatted according to the DSR default commands (shown in parentheses in the preceding list), you must disable them. Refer to the OpenVMS DIGITAL Standard Runoff Reference Manual for a complete list of the default commands provided by DSR and the commands you need to disable them. (Available on our documentation CD in Bookreader or PostScript.)

10.4 Creating Tables of Contents

To create a table of contents, perform the following steps:

The RUNOFF/CONTENTS command produces a table of contents with the following features:

• Chapter titles and numbers (generated by the .CHAPTER command).
• Section titles and numbers (generated by the .HEADER LEVEL command). By default, DSR allows up to six levels of headers to appear in the table of contents.
• Appendix titles and letters (generated by the .APPENDIX command).
• Chapter-oriented page numbers (1--1, 1--2, 1--3,...) for all table of contents entries.
• An output file with the same name as the input file.

The following example shows the commands and default output associated with producing a table of contents.

$  RUNOFF/INTERMEDIATE FUN.RNO
$  RUNOFF/CONTENTS FUN.BRN
$  RUNOFF FUN.RNT
$  TYPE FUN.MEC

                               CONTENTS



CHAPTER 1       How to Tile a Floor

        1.1     Reading About Tiling . . . . . . . . . . 1-1
        1.1.1     Tiling for Fun . . . . . . . . . . . . 1-2
        1.1.2     Your Home in Tile  . . . . . . . . . . 1-3
        1.1.3     Changing a Room with Tile  . . . . . . 1-3
        1.2     Buying the Tile  . . . . . . . . . . . . 1-5
        1.2.1     Researching Tiles Produced Abroad. . . 1-5
        1.2.2     Coordinating Colors  . . . . . . . . . 1-6
        1.2.3     Tile Textures  . . . . . . . . . . . . 1-6
        1.2.4     Types of Tiles . . . . . . . . . . . . 1-7
        1.2.4.1   Ceramic  . . . . . . . . . . . . . . . 1-7
        1.2.4.2   Clay . . . . . . . . . . . . . . . . . 1-7
        1.3     Tools for Tiles  . . . . . . . . . . . . 1-8
        1.3.1     Renting a Cutter . . . . . . . . . . . 1-8
        1.3.2     Buying or Renting Crimpers . . . . . . 1-9
        1.4     Accompanying Materials . . . . . . . . . 1-9
        1.4.1     How to Adhere the Tiles  . . . . . . . 1-9
        1.4.2     Grout  . . . . . . . . . . . . . . .  1-10
CHAPTER 2       How to Cedar a Ceiling

        2.1     Getting Started  . . . . . . . . . . .   2-1
        2.1.1     Various Surfaces . . . . . . . . . .   2-2

To tailor the DSR Table of Contents utility to meet your own needs, use the qualifiers listed in Table 10-2.

Changing Page Number Display in a Table of Contents

The following example shows how to change the display of page numbers from chapter-oriented numbers (1--1, 1--2, 1--3,...) to running numbers (1, 2, 3,...):

$ RUNOFF/CONTENTS/PAGE_NUMBERS=RUNNING FUN.MEC
$ TYPE FUN.MEC

                               CONTENTS



CHAPTER 1       How to Tile a Floor

        1.1     Reading About Tiling . . . . . . . . . . . 1
        1.1.1     Tiling for Fun . . . . . . . . . . . . . 2
        1.1.2     Your Home in Tile  . . . . . . . . . . . 3
        1.1.3     Changing a Room with Tile  . . . . . . . 3
        1.2     Buying the Tile  . . . . . . . . . . . . . 5
        1.2.1     Researching Tiles Produced Abroad. . . . 5
        1.2.2     Coordinating Colors  . . . . . . . . . . 6
        1.2.3     Tile Textures  . . . . . . . . . . . . . 6
        1.2.4     Types of Tiles . . . . . . . . . . . . . 7
        1.2.4.1   Ceramic  . . . . . . . . . . . . . . . . 7
        1.2.4.2   Clay . . . . . . . . . . . . . . . . . . 7
        1.3     Tools for Tiles  . . . . . . . . . . . . . 8
        1.3.1     Renting a Cutter . . . . . . . . . . . . 8
        1.3.2     Buying or Renting Crimpers . . . . . . . 9
        1.4     Accompanying Materials . . . . . . . . . . 9
        1.4.1     How to Adhere the Tiles  . . . . . . . . 9
        1.4.2     Grout  . . . . . . . . . . . . . . . .  10

CHAPTER 2       How to Cedar a Ceiling

        2.1     Getting Started  . . . . . . . . . . . . . 1
        2.1.1     Various Surfaces . . . . . . . . . . . . 2