Finishes the <varargs.h> or <stdarg.h> session.
Format
#include <stdarg.h> (ANSI C)
#include <varargs.h> (DEC C Extension)
void va_end (va_list ap);
Additional Information:
explode
extract
DSR flags are special characters that you enter to specify
emphasis of text, case of characters, spacing of text, and other
formatting details.
1 – 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.
1.1 – Default
Recognition is turned on.
2 – 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 (^*) turns on the bolding until the lowercase/bold
pair (\*) is encountered.
2.1 – Default
Recognition is turned off. To turn on recognition, you must use
the .FLAGS BOLD command.
3 – Break
The Break flag (|) tells DSR where it may break a word that
occurs at the end of a line. You might want DSR to be able to
break a word after a slash (/) or a hyphen (-) that is part
of the word (for example, "a yes/no response"). The Break flag
allows a line to end where the flag occurs; no hyphen is ever
inserted because of it.
If the flag is turned on and inserted at break points, DSR is
able to break the word at any of the specified points. If more
than one Break flag is present in a word that DSR is breaking at
the end of a line, DSR leaves as much of the word as possible on
the line; that is, it breaks the word at the last possible Break
flag.
The Break flag works the same whether .JUSTIFY or .NO JUSTIFY is
in effect.
3.1 – Default
Recognition is turned off. To turn on recognition, you must use
the .FLAGS BREAK command.
4 – Capitalize
The Capitalize flag (<) causes all the letters in the word
directly following it to be capitalized, except for letters that
may be preceded by an Accept (_) or Lowercase (\) flag.
Capitalization continues until one of the following is
encountered:
An expandable space
A Break flag (|)
A Hyphenate flag (=)
Another Capitalize flag
A pair of Uppercase flags (^^)
A pair of Lowercase flags (\\)
The end of the line
You can pair the Capitalize flag with the Uppercase flag (^<) to
capitalize all following text up to the next case flag.
4.1 – Default
Recognition is turned off. To turn on recognition, you must use
the .FLAGS CAPITALIZE command.
5 – Comment
The Comment flag (!) is used to insert comments in .RNO files.
You type the comment text immediately after the Comment flag.
Comments do not appear in the output file.
5.1 – Default
Recognition is turned on.
6 – Control
The Control flag (.) is placed at the left margin to begin a
string of DSR commands. When you want a period to be accepted as
a text character, you do not need to precede it with an Accept
flag (_) as long as the period is not placed at the left margin.
If you do need to have a period in the 0 character position
(and it is not part of a DSR command), you must precede it with
an Accept flag. Alternatively, you can use two periods at the
beginning of a line; the effect is the same as if you had used an
Accept flag.
6.1 – Default
Recognition is turned on.
7 – Hyphenate
When the Hyphenate flag (=) is turned on and inserted between
syllables of a word, DSR knows where the word can be broken at
the end of a line. DSR inserts a hyphen where the break occurs.
If DSR does not find it necessary to break the word, however,
the hyphen does not appear. By default, the Hyphenate flag is
disabled.
The action of this flag (as opposed to the recognition of the
flag) can be disabled or reenabled by the .DISABLE HYPHENATION
and .ENABLE HYPHENATION commands.
7.1 – Default
Recognition is turned off. To turn on recognition, you must use
the .FLAGS HYPHENATE command.
8 – Index
With the Index flag (>), you can mark words in the text of your
document as index entries. Using the .INDEX command instead of
the Index flag is a more common way of marking index entries.
8.1 – Default
Recognition is turned off. To turn on recognition, you must use
the .FLAGS INDEX command.
9 – Lowercase
The Lowercase flag (\) causes the letter that directly follows it
to appear in lowercase. The flag has no effect if the character
following it is not a letter.
The Lowercase flag can be paired as follows:
o With the Underline flag (\&) to stop underlining text.
o With the Bold flag (\*) to stop bolding characters.
o With itself (\\) to cause the characters following it to be
printed in lowercase by default. If you have a file that is
in all uppercase, you can put a paired lowercase flag (\\)
at the beginning of the file and then, as needed, override
the temporary lowercase default by using a circumflex (^) to
capitalize the letter following it.
9.1 – Default
Recognition is turned on.
10 – Overstrike
When the Overstrike flag (%) is turned on and inserted between
two characters, it causes the first of the two characters to be
overstruck by the following one. By default, the Overstrike flag
is disabled.
This capability allows the printing of characters not normally
available, for example, a European 7, which is a 7 overstruck
with a hyphen.
Three or more characters can be overstruck, but only if you
specify the /BACKSPACE qualifier in the DSR command line.
Otherwise, only the first and last characters in an overstrike
sequence will appear.
The action performed by this flag (as opposed to the flag's
recognition) can be disabled and reenabled by the .DISABLE
OVERSTRIKING and .ENABLE OVERSTRIKING commands.
10.1 – Default
Recognition i