1 10/20/86  retain_symbols, rsb
 2 
 3 Syntax as a command:  rsb input_path {output_path} {-control_args}
 4 
 5 
 6 Function:  takes an input text segment and inserts Speedtype escape
 7 characters wherever symbols would be expanded if this text segment were
 8 being processed by the expand_symbols command.  All symbols in the text
 9 segment are thus retained during future expansion.
10 
11 
12 Arguments:
13 input_path
14    is the pathname of the input text segment.
15 output_path
16    is the optional pathname of an output text segment.  If no output
17    pathname is specified, the original contents of the input text
18    segment are overwritten.
19 
20 
21 Control arguments:
22 -perm
23    specifies that the perm escape character is to be used.  (Default)
24 -temp
25    specifies that the temp escape character is to be used.  Specifying
26    this control argument causes the symbols in the output text segment
27    to be retained for only one expansion.
28 
29 
30 Notes:  In addition to inserting the specified escape character
31 wherever necessary, all existing pad escapes are converted to the
32 specified escape.  This allows for more convenient editing of the input
33 text segment, since all escape characters are thus printable.
34