to the table of contents. 3 .SET_DATE The .SET DATE and .SET TIME commands let you specify a date and time to be inserted in your file when you issue the Substitute flag pair, $$, with any of the appropriate date or time parameters. .SET DATE also sets the date for the .DATE command, which causes the date to appear in running heads. Formats .SET DATE d1 ,d2 ,d3 .SET TIME t1 ,t2 ,t3 Abreviated formats .SDT d1 ,d2 ,d3 .STM t1 ,t2 ,t3 4 Parameters d1 A number specifying the day of the month d2 A number specifying the month of the year d3 A number specifying the year (either four digits or the last two digits of the year) t1 A number specifying the hour of the day t2 A number specifying minutes past the hour t3 A number specifying seconds past the minute If you precede any of these values with a plus sign (+) or a minus sign (-), you will change the corresponding current value by adding to or subtracting from it the value following the + or -. 4 Defaults o If you do not enter .SET DATE or .SET TIME, entering a $$time, $$date, or any of the appropriate date or time parameters with the substitute flag pair ($$) will give you the date or time that DSR began processing the file. o If you enter either of these .SET commands, you can retain a previous value by omitting its value from the command. You must, however, type any comma that would have followed it. o If you enter either command without specifying any values for it, you will get the current date or the time as of the second the command is executed. 3 .SET_LEVEL The .SET LEVEL command allows you to preset the level of the next section head without entering a .HEADER LEVEL command (see .HEADER LEVEL). Format .SET LEVEL [+/-]n Abreviated format .SL [+/-]n 4 Parameters n Specifies the level for the next .HEADER LEVEL command. +n Makes the level for the next .HEADER LEVEL command n more than the current level. -n Makes the level for the next .HEADER LEVEL command n less than the current level. 3 .SET_PARAGRAPH The .SET PARAGRAPH command allows you to set values for .PARAGRAPH without entering .PARAGRAPH. The .SET PARAGRAPH command can be especially useful if you plan to execute .AUTOPARAGRAPH or .AUTOTABLE. (See .PARAGRAPH.) Format .SET PARAGRAPH [[-]n1 [,[-]n2 [,n3]]] Abreviated format .SPR [[-]n1 [,[-]n2 [,n3]]] The parameters n1, n2, and n3 are identical to the values of the .PARAGRAPH command. If you choose not to use one of these optional parameters, you must use a comma as a placeholder for the missing parameter in the parameter list. 4 Parameters n1 = spaces indented (The default is 5.) Specifies (like .INDENT) how many character positions to the right of the .LEFT MARGIN setting the first line of text will begin. -n1 Specifies how many character positions to the left of the .LEFT MARGIN setting the first line of text will begin; -n1 cannot, however, cause the text to begin to the left of character position 0. n2 = vertical spacing (The default is 1.) Specifies (like .SKIP) the number of blank lines you want inserted before the paragraph. You get additional blank lines if the .SPACING value is greater than 1. -n2 Specifies that the next line of text be pushed to within n2 lines of the bottom of the current page by the insertion of blank lines. Every line but the last one retains the line spacing (.SPACING value) that follows it. n3 = test page lines (The default is 2.) Specifies (like .TEST PAGE) the number of lines of text required to be on one page. Unlike the .TEST PAGE command itself, n3 takes into account any blank lines that .SPACING routinely inserts after each line of text. If there is not enough room on the current page to accommodate that many lines, DSR puts the text on the next page. You can cancel this function by specifying 0 for n3. 3 .SKIP The .SKIP command inserts a multiple of the number of blank lines that has been specified by the .SPACING command. Contrast this with .BLANK, which inserts only the number of blank lines specified with the .BLANK command itself. (See .BLANK.) Format .SKIP [[-]n] Abreviated format .S [[-]n] 4 Parameters n The number of .SPACING lines you want inserted. For example, if you have specified a .SPACING value of two lines and you enter .SKIP without an n value, DSR will insert two blank lines (the .SPACING value). If you enter .SKIP 2, DSR will insert four blank lines (2 times the .SPACING value), and so on. -n Specifies that the next line of text be pushed to within n lines of the bottom of the current page by the insertion of blank lines. Every line but the last one retains the line spacing (.SPACING value) that follows it. 4 Default If you enter no value for .SKIP, and you have entered no .SPACING command, you get .SKIP 1. 3 .SPACING The .SPACING command changes the amount of spacing between lines of text. Format .SPACING n Abreviated format .SP n 4 Parameter n The amount of spacing that you want between lines of text. For example, 1 denotes single spacing (no blank lines between lines of text). You must specify n, which must be within the range of 1 to 5, inclusively. 4 Default If you do not enter a .SPACING command, you get single spacing (.SPACING 1). 3 .STYLE_HEADERS The .STYLE HEADERS command changes the format and placement of the text portion of section heads (that is, the .HEADER LEVEL n text). Format .STYLE HEADERS [n1] [,n2]...[,n9] Abreviated format .STHL [n1] [,n2]...[,n9] 4 Parameters n1 (The default is 3.) Specifies the lowest-numbered header level to have the section title run-in to the paragraph that it heads. The text immediately follows the header title on the same line instead of beginning a new paragraph. All higher-numbered levels also have run-in formats. If n1=4, then .HEADER LEVEL 4, 5, and 6 titles are run into the main text. All lower levels will have the title separated from the text by blank lines (see parameter n7 for number of blank lines). n2 (The default is 1.) Specifies the highest-numbered header level to have its title printed entirely in uppercase. All lower-numbered levels will also have titles entirely in uppercase. If n2=4, then .HEADER LEVEL 1, 2, 3, and 4 will have titles in uppercase. n3 (The default is 6.) Specifies the highest-numbered header level to have only the first letter of each word capitalized in the title. All lower- numbered levels will also have titles in mixed format. If n3=6, all levels will have this case format. All uppercase takes precedence over initial capital letters, if there is a conflict. n4 (The default is 7.) Specifies the lowest-numbered header level not to have a section number to the left of its title. All higher-numbered levels will also not have section numbers to the left of their titles. Because there are only 6 header levels, the default of 7 indicates that all headers numbered. n5 (The default is 7.) Specifies the lowest numbered non-run-in header level to have its title centered. All higher-numbered non-run-in levels will also have their titles centered. Because there are only 6 header levels, the default value of 7 indicates that no header titles are centered. n6 (The default is 3.) Specifies the number of blank lines you want before section heads. n7 (The default is 1.) Specifies the number of blank lines you want after non-run-in section heads before the text is printed. n8 (The default is 9.) Specifies the number of lines you want to have available on the current page for the test page issued by .HEADER LEVEL. Note that n8 takes into account any blank lines that .SPACING routinely inserts after each line of text (unlike .TEST PAGE). (See also .SKIP.) n9 (The default is 2.) Specifies the number of spaces you want between the section number and the section title. The maximum value is 75. 4 Defaults If you do not specify a value for any given n, DSR supplies the following default values: n1=3 Run-in titles for header levels 3 to 6. n2=1 Titles in all uppercase for header level 1 only. n3=6 Titles with only the first letter of every word in uppercase for header level 2 to header level 6. n4=7 A sequence of numbers (or letters) preceding the section title. (See .DISPLAY LEVELS.) n5=7 Titles printed starting at the left margin (flush left), not centered. n6=3 Three blank lines before each header. n7=1 One blank line after each header. n8=9 Seven more than the test-page value of the most recent .PARAGRAPH or .SET PARAGRAPH command you have entered. If you have not specified such a value, you get 7 plus the .PARAGRAPH default of 2. (See the description of n8 for note on .SPACING adjustment.) n9=2 Two spaces between the section number of the header and the header itself (section title). 3 .SUBPAGE The .SUBPAGE command begins a new page and a new format for page numbering. It numbers the new page by keeping the previous page number and appending the letter A to it. For example, if the previous page is 10, the first subpage is 10A and the next page becomes 10B unless you enter an .END SUBPAGE command. (See also .NUMBER SUBPAGE, .DISPLAY SUBPAGE, .HEADERS ON, .LAYOUT, and .PAGE.) The .END SUBPAGE command begins a new page and goes back to normal page numbering. If you enter the .END SUBPAGE command on page 2-8D, for example, the next page would be numbered 2-9. Formats .SUBPAGE .END SUBPAGE Abreviated formats .SPG .ES 4 Default .SUBPAGE is not in effect. 3 .SUBTITLE The .SUBTITLE command allows you to specify a subtitle for a running head (see .HEADERS ON). When using the default .LAYOUT command, the subtitle appears on the second line of every page (except page 1) at the leftmost position on a line (character position 0), regardless of the left margin setting. The .NO SUBTITLE command cancels the .SUBTITLE command. (See also .AUTOSUBTITLE, .TITLE, .FIRST TITLE, and .LAYOUT.) Formats .SUBTITLE [text] .NO SUBTITLE Abreviated formats .ST [text] .NST 4 Parameter text The title of the running head you want to appear on the second line of the page. 4 Defaults o If you do not enter either .SUBTITLE or .NO SUBTITLE, you get .NO SUBTITLE. o If you enter the .SUBTITLE command without specifying subtitle text for it, you will get the effects of .AUTOSUBTITLE (provided you have not entered .NO AUTOSUBTITLE). o If .AUTOSUBTITLE is in effect and if the text picked up from an applicable .HEADER LEVEL command is wider than the margins in effect when the subtitle is displayed, the subtitle is truncated and an ellipsis (...) is appended to the end of it. 3 .TAB_STOPS The .TAB STOPS command 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. Format .TAB STOPS [[+/-]n1] [,[+/-]n2]...[,[+/-]n32] Abreviated format .TS [[+/-]n1] [,[+/-]n2]...[,[+/-]n32] 4 Defaults o If you enter the .TAB STOPS command without number or comma specifications, the use of all tab stops is suspended and the tab character is equivalent to a space. o If you do not enter the .TAB STOPS command, successive tab characters work as if you had set a tab stop every eight positions; that is, as if you had entered .TAB STOPS 8,16,24, and so on. Note that because .PAGE SIZE has a width limit of 150, 149 is the practical limit for .TAB STOPS. 3 .TEST_PAGE The .TEST PAGE command allows you to keep a specified amount of text entirely on a single page. If there is not enough room on the current page to accommodate that amount, DSR ends the current page and puts the entire text on the next page. Format .TEST PAGE n Abreviated format .TP n 4 Parameter n The number of lines required to be on one page. This number cannot be omitted and must be positive. 3 .TITLE The .TITLE command allows you to specify a title for a running head (see .HEADERS ON). This title normally appears at the top of every page but the first, at the leftmost position on the line (character position 0), regardless of the .LEFT MARGIN setting. (See also .FIRST TITLE, .SUBTITLE, and .LAYOUT.) Format .TITLE [text] Abreviated format .T [text] 4 Parameter text The title of the main running head you want to appear. 4 Default If you do not enter the .TITLE command, you get the title you specified in any .CHAPTER command that is in effect (unless you have entered .NO HEADERS). 3 .VARIABLE The .VARIABLE command 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. Format .VARIABLE name [t ,f] Abreviated format .VR name [t ,f] 4 Parameters name The name you have given to the commands and text in an .IF (or .IFNOT) block. t (True) is a single character of your choice that appears in front of lines of text to indicate that they will be processed (.IF block) if you specify /VARIANT, instead of /DEBUG, in the command line. f (False) is a single character of your choice that appears in front of lines of text to indicate that they will not be processed (.IFNOT block) if you specify /VARIANT, instead of /DEBUG, in the command line. 3 .XLOWER The .XLOWER command allows you to control the case of index entries specified by the .INDEX and the .ENTRY commands, or by the Index flag (>). The case of the index entries will match exactly the case that you enter when you make the index entry. See also the .XUPPER command. Format .XLOWER Abreviated format .XL 4 Default If you do not specify the .XLOWER command, .XUPPER is the default. 3 .XUPPER The .XUPPER command lets DSR control the case of index entries. If .XUPPER is in effect (as it is by default), DSR capitalizes the first character of every index entry and drops everything else in the entry to lowercase. See also the .XLOWER command. Formats .XUPPER Abreviated formats .XU 4 Default .XUPPER 2 DSR_Flags DSR flags are special characters that you enter to specify emphasis of text, case of characters, spacing of text, and other formatting details. 3 Accept The Accept flag (_) causes any character that directly follows it to be accepted as text. If the character is a punctuation mark after which DSR normally inserts an extra space (for example, a period), you can precede it with the Accept flag to cancel the extra space. If you want to insert a flag character into your text, the easiest way is to precede it with the Accept flag. For example, to insert an ampersand (&), which is also the Underline flag, type _&. For underlining purposes, you can use the Accept flag to cause the acceptance of an expandable space (one you produce by pressing the SPACE bar) because DSR normally does not underline spaces between words. 4 Default Recognition is turned on. 3 Bold The single character occurrence of the Bold flag (*) causes the next character to be printed in boldface; that is, to be overstruck once. You can cause characters to be overstruck more than once by using the /BOLD=number qualifier when processing the file with the RUNOFF command. Pairing the bold flag with the uppercase flag (