Document revision date: 19 July 1999
[Compaq] [Go to the documentation home page] [How to order documentation] [Help on this site] [How to contact us]
[OpenVMS documentation]

OpenVMS User's Manual


Previous Contents Index

10.6.7 Horizontal Spacing

The following table lists all DSR commands used for controlling horizontal spacing:
Command Description
.CENTER
.CENTER
.C Centers a single line of text around a character position on a line.
.INDENT .I Causes the first line of text following it to begin at a position relative to the left margin.
.NO PERIOD
.PERIOD
.NPR
.PR
Cancel and restore the routine insertion of an extra space after any of the following punctuation marks: period (.), colon (:), question mark (?), and exclamation point (!).
.RIGHT .R Positions a single line of text relative to the right margin. (See also .CENTER.)
.TAB STOPS .TS Changes the current positions of tab stops. Each tab character in the input file advances the print carriage to the right to the next tab stop.

10.6.8 Paragraph Formatting

The following table lists all DSR commands used for formatting paragraphs:
Command Description
.AUTOPARAGRAPH
.NO AUTOPARAGRAPH
.AP
.NAP
Enable and disable starting a new paragraph each time a line starts with a space, a tab, or a blank line. Cancels .AUTOTABLE.
.AUTOTABLE
.NO AUTOTABLE
.AT
.NAT
Enable and disable starting a new paragraph each time a line does not start with a space or a tab. Cancels .AUTOPARAGRAPH.
.PARAGRAPH .P Controls spacing and page placement associated with the creation of paragraphs. (See also .SET PARAGRAPH.)
.SET PARAGRAPH .SPR Allows you to set values for .PARAGRAPH without entering .PARAGRAPH (for example, when you are using .AUTOPARAGRAPH).

10.6.9 Text Emphasis

The following table lists all DSR commands used for emphasizing text:
Command Description
.ENABLE BAR
.DISABLE BAR
.EBB
.DBB
Enable and disable the use of change bars, vertical bars (|) inserted to indicate where changes in text have occurred since the previous edition of a document.
.BEGIN BAR
.END BAR
.BB
.EB
Determine where DSR starts and stops inserting change bars at the beginning of lines.
.ENABLE BOLDING
.DISABLE BOLDING
.EBO
.DBO
Enable and disable use of the Bold flag (*) to indicate bolding, if the .FLAGS BOLD flag is enabled.
.ENABLE HYPHENATION
.DISABLE HYPHENATION
.EHY
.DHY
Enable and disable use of the Hyphenate flag (=) to indicate hyphenation, if the .FLAGS HYPHENATE flag is enabled.
.ENABLE OVERSTRIKING
.DISABLE OVERSTRIKING
.EOV
.DOV
Enable and disable use of the Overstrike flag (%) to create special characters that are not available on the terminal by overstriking any printing character with another. Recognition of the .FLAGS OVERSTRIKE flag must be enabled.
.ENABLE UNDERLINING
.DISABLE UNDERLINING
.EUN
.DUL
Enable and disable use of the Underline flag (&) to underline text, if the .FLAGS UNDERLINE flag is enabled.

10.6.10 Figure Formatting

The following table lists all DSR commands used for formatting figures:
Command Description
.FIGURE .FG Leaves room on a page for you to insert a figure later. If there is not enough room on the current page, DSR ends the page immediately and then puts the blank lines at the top of the next page.
.FIGURE DEFERRED .FGD Leaves room on a page for you to insert a figure later. If there is not enough room on the current page, .FIGURE DEFERRED first adds enough text to complete the page and then puts the required number of blank lines at the top of the next page.
.LITERAL
.END LITERAL
.LT
.EL
Allow you to have your text formatted exactly as you have typed it. DSR commands and flags are not recognized and are treated as ordinary text. Tab stops set prior to the .LITERAL command, however, remain in effect (see .TAB STOPS).

10.6.11 List Formatting

The following table lists all DSR commands used for formatting lists:
Command Description
.DISPLAY ELEMENTS .DLE Allows you to specify the form that sequential numbering or lettering of items in a list will take.
.LIST
.END LIST
.LS
.ELS
Specifies the beginning of a list by resetting the left margin farther to the right, by setting a .SKIP command value to take effect before each item in the list, and by executing the .TEST PAGE command.

The .END LIST command ends a list, restoring any fill, justify, case, margin, or spacing settings that were in effect before you entered the most recent .LIST command.

.LIST ELEMENT .LE Specifies the beginning of each item in a list.
.NUMBER LIST .NMLS Allows you to specify, anywhere in a list, the number with which a sequence of items in a list will begin. Enter this command just before the .LIST ELEMENT command that you want to affect. Subsequent list elements will each have a number that is one greater than the number for the preceding .LIST ELEMENT command. (See also .DISPLAY ELEMENTS, with which you can specify the form the number will take.)

10.6.12 Note and Footnote Formatting

The following table lists all DSR commands used for creating notes and footnotes:
Command Description
.FOOTNOTE
.END FOOTNOTE
.FN
.EFN
Places text at the bottom of the current page. If there is not enough space on the current page for the entire footnote, DSR places the entire note at the bottom of the next page.

The .END FOOTNOTE command ends the footnote and restores any case, fill, justify, spacing, or margin settings that you might have changed within the footnote.

.NOTE
.END NOTE
.NT
.EN
Highlights a portion of text by narrowing the margin settings, centering the text on the page, and printing a title centered over the text.

The .END NOTE command restores the fill, justify, case, margin, and spacing settings that were in effect just before you entered the .NOTE.

10.6.13 Chapter and Appendix Formatting

The following table lists all DSR commands used for formatting chapters and appendixes:
Command Description
.APPENDIX .AX Specifies the beginning of an appendix, assigns an identifying letter to it, and allows you to supply a title.
.CHAPTER .CH Specifies the beginning of a chapter, assigns an identifying number to it, and allows you to supply a title.
.DISPLAY APPENDIX .DAX Allows you to specify the form that the lettering (or numbering) of appendixes will take. The form you specify appears in the title, the page numbers, and the first character of header-level numbers throughout the appendix.
.DISPLAY CHAPTER .DCH Allows you to specify the form that the numbering (or lettering) of chapters will take. The form you specify appears in the title, the page numbers, and the first character of header-level numbers throughout the chapter.
.NUMBER APPENDIX .NMAX Allows you to specify an identifying letter with which a sequence of appendixes will begin. The next .APPENDIX command starts the sequence. Subsequent .APPENDIX commands cause appendixes to be lettered in alphabetic order. (See also .DISPLAY APPENDIX.)
.NUMBER CHAPTER .NMCH Allows you to specify the number with which a sequence of chapters will begin. The next .CHAPTER command starts the sequence. Subsequent .CHAPTER commands will cause each chapter to be numbered one higher than the previous chapter. (See also .DISPLAY CHAPTER.)

10.6.14 Section Formatting

The following table lists all DSR commands used for formatting sections:
Command Description
.DISPLAY LEVELS .DHL Allows you to specify the form that sequential numbering (or lettering) of section headers will take.
.HEADER LEVEL .HL Allows you to specify both a section number and a section title. Successive .HEADER LEVEL commands of the same value cause the section numbers to increase sequentially (all .HEADER LEVEL 1 commands, for example).
.NUMBER LEVEL .NMLV Allows you to specify the beginning number of a sequence of headers. (See also .STYLE HEADERS and .DISPLAY LEVELS.)
.SET LEVEL .SL Allows you to preset the level of the next section head without entering a .HEADER LEVEL command (see .HEADER LEVEL).
.STYLE HEADERS .STHL Changes the formats of the various levels of section headers (.HEADER LEVEL n).

10.6.15 Index Formatting

The following table lists all DSR commands used for formatting indexes:
Command Description
.ENABLE INDEXING
.DISABLE INDEXING
.EIX
.DIX
Enable and disable the operation of the indexing commands (.INDEX and .ENTRY) and the Index flag (>).
.ENTRY .Y Creates an index entry without a page number reference. It is usually used for "See" or "See also" index entries.
.FLAGS INDEX
.NO FLAGS INDEX
.FL INDEX
.NFL INDEX
Enable and disable recognition of the Index flag character (>).
.FLAGS SUBINDEX
.NO FLAGS SUBINDEX
.FL SUBINDEX
.NFL SUBINDEX
Enable and disable recognition of the Subindex flag (>). The .FLAGS SUBINDEX command can change the Subindex flag to another character. The .NO FLAGS SUBINDEX can include a right angle bracket (>) as part of your indexed text, instead of causing subindexing.
.INDEX .X Creates an index entry with a page number reference.
.XLOWER
.XUPPER
.XL
.XU
Determine whether you control the case of index entries specified by the .INDEX and the .ENTRY commands or by the Index flag (>). When you enter the .XLOWER command, the case of the index entries matches exactly the case that you enter when you make the index entry. When you enter the .XUPPER command, DSR capitalizes the first character of every index entry and drops everything else in the entry to lowercase.

10.6.16 Tables of Contents Formatting

The following table lists all DSR commands used for formatting tables of contents:
Command Description
.ENABLE TOC
.DISABLE TOC
.ETC
.DTC
Enable and disable use of information collected by DSR to create a table of contents.
.SEND TOC .STC Allows you to control the appearance of the table of contents (.RNT) file by inserting DSR commands, DSR flags, and text.

10.6.17 Flag Recognition Commands

The following table lists all DSR commands used for flag recognition:
Command Description
.FLAGS ACCEPT
.NO FLAGS ACCEPT
.FL ACCEPT
.NFL ACCEPT
Control recognition of the Accept flag character (_).
.FLAGS ALL
.NO FLAGS ALL
.FL
.NFL
Serve as master switches for all other flag (.FLAG and .NO FLAG) settings, except the .FLAGS COMMENT, .NO FLAGS COMMENT, .FLAGS CONTROL, and .NO FLAGS CONTROL commands.

The .FLAGS ALL and .NO FLAGS ALL commands enable and disable recognition of all flags without disturbing other flag command settings. (An analogy for flag recognition is turning on a master switch [entering .FLAGS ALL] --- those lights with switches in the ON position will go on and those with switches in the OFF position will not go on.) See also .ENABLE BOLDING and .DISABLE BOLDING, .HYPHENATION, .INDEXING, .OVERSTRIKING, and .UNDERLINING commands.

.FLAGS BOLD
.NO FLAGS BOLD
.FL BOLD
.NFL BOLD
Enable and disable recognition of the Bold flag character (*).
.FLAGS BREAK
.NO FLAGS BREAK
.FL BREAK
.NFL BREAK
Enable and disable recognition of the Break flag character (|), which specifies the place at which a new page should begin.
.FLAGS CAPITALIZE
.NO FLAGS CAPITALIZE
.FL CAPITALIZE
.NFL CAPITALIZE
Enable and disable recognition of the Capitalize flag character (<).
.FLAGS COMMENT
.NO FLAGS COMMENT
.FL COMMENT
.NFL COMMENT
Enable and disable recognition of the Comment flag character (!).
.FLAGS CONTROL
.NO FLAGS CONTROL
.FL CONTROL
.NFL CONTROL
Control recognition of the Control flag character (the period that begins a DSR command). The .FLAGS CONTROL command changes the character that precedes the commands from a period to a character of your choice. The .NO FLAGS CONTROL command disables recognition of the Control flag character.
.FLAGS HYPHENATE
.NO FLAGS HYPHENATE
.FL HYPHENATE
.NFL HYPHENATE
Enable and disable recognition of the Hyphenate flag character (=).
.FLAGS LOWERCASE
.NO FLAGS LOWERCASE
.FL LOWERCASE
.NFL LOWERCASE
Enable and disable recognition of the Lowercase flag character (\).
.FLAGS OVERSTRIKE
.NO FLAGS OVERSTRIKE
.FL OVERSTRIKE
.NFL OVERSTRIKE
Enable and disable recognition of the Overstrike flag character (%).
.FLAGS PERIOD
.NO FLAGS PERIOD
.FL PERIOD
.NFL PERIOD
Enable and disable recognition of the Period flag character (+).
.FLAGS SPACE
.NO FLAGS SPACE
.FL SPACE
.NFL SPACE
Enable and disable recognition of the Space flag character (#).
.FLAGS SUBSTITUTE
.NO FLAGS SUBSTITUTE
.FL SUBSTITUTE
.NFL SUBSTITUTE
Enable and disable recognition of the Substitute flag character ($). Note that you must use a pair of Substitute flag characters to make the substitution occur.
.FLAGS UNDERLINE
.NO FLAGS UNDERLINE
.FL UNDERLINE
.NFL UNDERLINE
Enable and disable recognition of the Underline flag character (&).
.FLAGS UPPERCASE
.NO FLAGS UPPERCASE
.FL UPPERCASE
.NFL UPPERCASE
Enable and disable recognition of the Uppercase flag (^).

10.6.18 Other DSR Commands

The following table lists other miscellaneous DSR commands:
Command Description
.CONTROL CHARACTERS
.NO CONTROL CHARACTERS
.CC
.NCC
Enable and disable use of control characters as normal text in your input file.
.IF
.IFNOT
.ELSE
.ENDIF
--
--
.EI
.IN
Cause portions of a DSR file to be processed or not processed, according to conditions that you specify.
.NO SPACE .NSP Prevents the insertion of the end-of-line space for one line of text only, causing the characters at the end of one line and the beginning of the next to be adjacent.
.REPEAT .RPT Allows you to specify up to 150 characters to be printed a specified number of times, either horizontally or vertically.
.REQUIRE .REQ Allows you to process several DSR files at the same time and merge them in an output file.
.SAVE
.RESTORE
.SA
.RE
Maintain the current RUNOFF formatting context of a document, including DSR defaults as well as DSR commands and flags.
.SET DATE
.SET TIME
.SDT
.STM
Specify a date and time to be inserted in your file when you use the Substitute flag pair, $$, with any of the appropriate date or time parameters. The .SET DATE command also sets the date for the .DATE command, which causes the date to appear in running heads.
.VARIABLE .VR Allows you to specify a character that corresponds to the name you have given the commands and text in an .IF (or .IFNOT) block. This identifying character is placed in the left margin when you process your file with the /DEBUG or /DEBUG=CONDITIONALS command line qualifier.


Previous Next Contents Index

  [Go to the documentation home page] [How to order documentation] [Help on this site] [How to contact us]  
  privacy and legal statement  
6489PRO_023.HTML