|Document revision date: 30 March 2001|
The following table describes commands and keys that can be used to process EDT commands:
|Keypad Mode||Line Mode||Nokeypad Mode||Description|
|Ctrl/C||Ctrl/C||Ctrl/C||Interrupts certain operations (such as a search through a long file) before EDT finishes processing them.|
|Do (LK201 only)||Return||Period (.)||Processes searches and line editing commands.|
|Enter||Return||Return||Processes searches, line editing commands, and key definitions.|
|SET ENTITY||Defines the delimiters that mark the word, sentence, paragraph, and page boundaries for commands and functions.|
|SHOW ENTITY||Lists the current delimiters.|
|SET COMMAND||Processes additional startup command files at the beginning of your EDT session. This command is valid only in an EDT startup command file.|
|SHOW COMMAND||Displays the name of the active startup command file. This command is valid only in an EDT startup command file.|
|Displays the commands in a startup command file or EDT macro as the commands are processed. SHOW VERIFY indicates whether SET VERIFY is in effect.|
The following table describes miscellaneous commands and keys available in EDT:
|Keypad Mode||Line Mode||Nokeypad Mode||Description|
|DATE||Inserts the current date into your text.|
|DEFINE MACRO||Creates new line-mode commands for the duration of your editing session.|
|EXIT||Creates an external file, copies the contents of the MAIN buffer into that file, and ends the editing session.|
|GOLD||Performs various editing functions when used with other keypad and keyboard keys.|
|Help||Help||Help||In keypad and line modes, accesses the EDT Help utility. In nokeypad mode, defines a different key or key sequence in keypad mode to carry out the keypad Help function.|
|Copies the specified range of lines or specified buffer to an external file in a specified directory. EDT adds a form feed and two blank lines for every 60 lines it copies. The EDT line numbers become part of the text in the external file.|
|QUIT||QUIT||Ends the session without copying text to an external file.|
|RESEQUENCE||Assigns new EDT line numbers to the lines of the current or specified buffer.|
|SHOW FILES||Displays the current input file and output file for your EDT session.|
|SET [NO]FNF||Suppresses the message that appears when you use EDT to create a new file (FNF stands for File Not Found). This command is used only in startup command files.|
|SHOW FNF||Indicates whether SET FNF or SET NOFNF is in effect. This command is used only in startup command files.|
|SET HELP||Enables you to access different help files for your EDT session.|
|SHOW HELP||Displays the name of the help file currently available for your editing session.|
|Suppresses summary information displayed when you enter the EXIT or WRITE commands. By default, EDT displays the complete file specification and number of lines in the file that EDT has created as a result of entering the EXIT or WRITE command. SHOW SUMMARY indicates whether the SET SUMMARY command is in effect.|
|SHOW VERSION||Displays the version of EDT that is being used by your operating system.|
|TYPE||Displays lines of text at your terminal.|
|WRITE||Copies text from an EDT buffer to an external file.|
|XLATE||Passes information back to the calling program. You can enter this command when EDT has been called by a running program.|
DIGITAL Standard Runoff (DSR) is a text-formatting facility. This chapter describes:
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
10.1 About DSR
By inserting DSR commands, control characters, and other special identifiers within a text file, you can use DSR to:
The steps for formatting a file with DSR are as follows:
Create the source file with EDT, EVE, or another text editor.
By default, the DSR source file has the file type .RNO.
Enter DSR commands, flags, and control characters within the source
file to indicate how the file is to be formatted.
DSR flags are special characters that you insert in text to specify emphasis of text, case of characters, spacing of characters, and so forth.
Process the file with the DCL command RUNOFF.
When DSR processes the source file, the DSR commands cause the text to be formatted into sections, paragraphs, lists, and so on. Neither the DSR commands nor the DSR flags appear in the final document.
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.
$ RUNOFF FUN
$ 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.
|/BACKSPACE||Uses the Backspace character to bold, overstrike, or underline text as it is printed. This generally gives more exact underlining and bolding for files printed on letter-quality printers. The /BACKSPACE qualifier is not recommended for line printers.|
|/[NO]BOLD||Enables and disables bolding. Any bolding specified in chapter and header titles appears in the table of contents.|
|/[NO]CHANGE_BARS||Enables and disables the appearance of change bars in the output file.|
|/CONTENTS||Generates a table of contents. (See Section 10.4.)|
|/[NO]DEBUG||Traces the operation of certain DSR commands by causing the commands to appear in the output file.|
|/DEVICE||Specifies printing options.|
|/DOWN||Specifies the number of blank lines to be inserted at the top of each page, preceding any header information.|
|/INDEX||Generates an index. (See Section 10.5.)|
|/FORM_SIZE||Controls the number of lines that can be accommodated per page of output.|
|/[NO]INTERMEDIATE||Generates an intermediate binary file with the default file type .BRN for use with the DSR Table of Contents utility and the DSR Indexing utility.|
|/[NO]LOG||Controls whether or not DSR displays processing information at your terminal.|
|/MESSAGES||Lets you specify whether you want error messages displayed on your terminal or in an output file only. By default, DSR displays messages in both places.|
|/[NO]OUTPUT||Specifies the name of the output file produced by DSR.|
|/PAGES||Limits the output file to a specified range of pages.|
|/[NO]PAUSE||Controls whether DSR pauses after printing each page of output.|
|/REVERSE_EMPHASIS||Specifies that underlining of flagged text is to be done after the text is printed. By default, the printer prints the underscores, issues a carriage return without a line feed, then prints the flagged text above the underscores.|
|/[NO]RIGHT||Causes the text on each page to be shifted to the right.|
|/SEPARATE_UNDERLINE||Underlines text by using separate characters on the next line instead of overprinting with underscores on the same line.|
|/[NO]SEQUENCE||Controls whether DSR outputs line numbers from the input file.|
|/[NO]SIMULATE||Controls whether blank lines or form feeds are used to advance to the top of each page.|
|/[NO]UNDERLINE_CHAR||Allows you to specify the character to be used for underlining of flagged text.|
|/VARIANT||Controls the execution of the condition commands (.IF, .IFNOT, .ELSE, .ENDIF) by specifying the names of the segments to be processed.|
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:
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:
Generate an intermediate (binary) file.
Be sure to specify an .RNO file type. (DSR then produces a file with a .BRN file type, which contains both table of contents and indexing information.)
Run the Table of Contents utility.
Be sure to specify a .BRN file type. You can add qualifiers to this command line to customize the table of contents. (DSR then produces a file with an .RNT file type.)
Process the .RNT file.
Be sure to specify an .RNT file type. (DSR then produces a file with an .MEC file type, which contains the table of contents.)
The RUNOFF/CONTENTS command produces a table of contents with the following features:
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 220.127.116.11 Ceramic . . . . . . . . . . . . . . . 1-7 18.104.22.168 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.
|/BOLD||Enables bolding of chapter and header titles in the table of contents.|
|/DEEPEST_HEADER=n||Displays header levels up to and including level n.|
|/IDENTIFICATION||Displays the current version number of the DSR Table of Contents utility.|
|/INDENT||Indents each header level after header level 1, two spaces beyond the preceding header level.|
|/LOG||Reports the name of each input file as it is processed and after it is processed, plus the name of the generated output file.|
|Specifies the name of the output file produced by DSR. The /NOOUTPUT qualifier causes DSR to process the input file without creating an output file.|
|/PAGE_NUMBERS=RUNNING||Uses running page numbers instead of chapter-oriented page numbers for all table of contents entries, whether or not you specified running page numbers in the document.|
|/REQUIRE=filespec||Allows you to change the heading on the first page of a table of contents.|
|/NOSECTION_NUMBERS||Suppresses the display of section numbers for all header levels.|
|/UNDERLINE||Includes underlining specified in chapter and header titles in the table of contents.|
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 22.214.171.124 Ceramic . . . . . . . . . . . . . . . . 7 126.96.36.199 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
|privacy and legal statement|