.HL 1 SPECIAL CHARACTERS .INDEX SPECIAL CHARACTERS .helpb Flag__characters .if hlp .if rsx .dhy For Further Help: .br Underline Space Accept Uppercase Lowercase Control Capitalize Hyphenation Break Overstrike Period Equation Index User__defined NOTE .dhy .endif rsx .endif hlp .helpc Underline .q _&##Ampersand#####UNDERLINE .p.index Underline flag The character ampersand "_&" is used to specify underlining. The ampersand will cause the character following it to be underlined, e.g.#_&f_&o_&o becomes ^&foo\&. To begin underlining a whole section of text you precede the section by _^_& and follow the section by _\_&. Any spaces in the section will not be underlined. To underline a single space or tab precede it by _&. Text with imbedded spaces may be underlined spaces and all by issuing the command _.UNDERLINE " ". You may specify which characters may or may not be underlined by the _.UNDERLINE and _.NO UNDERLINE commands. .i5;(In DSR you underline spaces by preceding them with an accept flag "__".) .helpc Space .q _###Number-Sign###Quoted or non expandable SPACE .index Space>non expandable It is occasionally necessary to include spaces in the text which should not be treated as word separators. For this purpose, RUNOFF treats the number-sign character "_#" as a quoted space; i.e. it will print as exactly one space in the output. Normal spaces may be expanded to multiple spaces to justify the text, but quoted spaces may not be expanded. Also normal spaces mark the end of the previous word and the beginning of the next. Text with imbedded quoted spaces are not be broken at the quoted spaces and split into separate lines. .helpc Accept .q __##Underline#####ACCEPT or Quote character .index Quote flag .p.index Accept flag To allow the appearance of the special characters (ampersand, number-sign, circumflex, or back-slash) in the output, the underscore character "__" is used as an accept flag. The character immediately following an underscore will be transmitted to the output with no formatting effect. The underscore itself is thus another case requiring quoting. The following 12 cases occur: .c; ___& ___^ ___\ ____ ___$ ___| ___= ___% ___< ___# ___{ ___} If normal spaces or tabs are preceded by an ACCEPT character they are converted to non expandable spaces. .helpc Uppercase .q _^##Circumflex####UPPERCASE shift or mode lock .paragraph.x Uppercase flag As described above, the circumflex character "_^" is used to convert the letter following to upper-case. It is also used to lock the case mode in upper case, and the underline mode to "underline all text". If it is to appear in the printed text, it must be preceded by the quote character "___^". User-defined special flags may be locked on using the circumflex. For example if your printer supports bolding "_^_*" would be used to turn on bolding. .helpc Lowercase .q _\###Backslash####LOWERCASE shift or mode unlock .p.x Lowercase flag As described above, the backslash character "_\" is used to output the letter following in lower-case. It is also used to lock the case mode in lower-case, and to disable underlining. If it is to appear in the printed text, it must be preceded by the quote character "___\". It is also used to turn off special features, for example "_\_*" would be used to turn off bolding if your printer supports it. .helpc Capitalize .q _<##Less-than#####CAPITALIZE next word .p.x Capitalize flag If _.FLAGS CAPITALIZE has been defined, the less-than character "_<" is a special character used to capitalize the entire word it preceds. If it is to appear in the printed text, it must be preceded by the quote character "___<". An appearance of a circumflex followed by less than "_^_<" permanently locks Runoff into capitalize mode. This may be cancelled by a double circumflex "_^_^". This flag is not normally used with terminals that have lowercase. .helpc Hyphenation .q _=##Equals-sign###HYPHENATE character .p.x Hyphenate flag If _.FLAGS HYPHENATE has been specified the equals character "_=" used to control hyphenation. If it preceds a word the word will not be hyphenated. If it is imbedded inside a word it specifies where that word may be hyphenated. The word is only hyphenated if necessary to fill out a line. When hyphenation is specified for a word no automatic hyphenation is used. If this appears at the end of a line it specifies that the next line is a continuation of the current one and that a hyphen may appear at this point. If _= is to appear in the printed text, it must be preceded by the quote character "___=". .helpc Overstrike .q _%##Percent-Sign###OVERSTRIKE character .p.x Overstrike flag If _.FLAGS OVERSTRIKE has been defined, the percent character "_%" will generate a backspace to allow overstriking the previous character to form new composite characters. If overstriking is defined and you wish to use the percent in the text then it must be preceded by an underscore "___%". The default is _.NO FLAGS OVERSTRIKE. Multiple backspaces may be generated. You should be careful when using this feature. Backspacing past the left margin is not allowed, and some printers do not support backspacing. .i5;(DSR doesn't support multiple backspacing) .helpc Period .q _+##Plus###PERIOD character .p.x Period flag If _.FLAGS PERIOD has been defined the plus-Sign "_+" will generate an extra space if followed by a normal space. For example J_+#M will appear in the output as J##M. .helpc Control .q _.##Period###CONTROL character .p.x Control flag This flag marks the rest of a line as a control or command if it appears at the beginning of a line. .helpc Substitute .q _$##Dollar-Sign###SUBSTITUTE character .index Substitute character .s.x Substitute flag If _.FLAGS SUBSTITUTE has been enabled then the dollar sign marks the beginning of a substitution label. Runoff will then substitute some specified text for the label. The text may be specified by the _.DEFINE SUBSTITUTE command. Permanently defined substitutions are already available for the current date and time. See: _.FLAGS SUBSTITUTE. .helpc Break .q _|##Vertical bar###BREAK character .p.x Break flag If _.FLAGS BREAK is enabled this character marks where a word or expression may be broken. A word containing a break will not be hyphenated, but will be broken if necessary. Words may contain both specified hyphenation and break points. You may automatically specify breaks on a character by using the _.AUTOBREAK command. This flag also marks where a string is justified if _.TAB RIGHT is enabled. If this appears at the end of a line it specifies that the next line is a continuation of the current one. .helpc Index .q _>##Greater than###INDEX/SUBINDEX flags .p.x Index flag .x Subindex flag If _.FLAGS INDEX is enabled, this character may be used to mark terms to be indexed. If _.FLAGS SUBINDEX is enabled, the character may be used inside a _.INDEX command to denote subindex terms. For further explanation see the section on indexing. .helpc Equation .q _{ _} Braces###EQUATION formatting characters .p.x Equation flags If _.FLAGS EQUATION is enabled these characters are used to delimit either the numerator or denominator of a fraction. The numerator and denominator are further separated by a slash "/". .br;(Not available in DSR) .helpc User__defined .q ???? User defined flags The user may define any other special character as a flag by using the _.FLAGS SPECIAL or _.FLAGS ESCAPE commands. Any flag so defined obeys the printing rules defined above. The meaning of the flag is entirely up to the user. .br;(Not available in DSR) .end text .helpc NOTE .NOTE All of these flags may be undefined by a _.NO FLAGS command. They may be defined and changed to a different character by a _.FLAGS command. For example if you use the equals sign frequently you may change the hyphenation flag to the tilde which you seldom use by entering the following line: .i5;_.FLAGS HYPHENATE _~ .END NOTE