1 03/01/85  file_output, fo
 2 
 3 Syntax as a command:  fo {path} {-control_args}
 4 
 5 
 6 Function: directs I/O output switches to a specified file.  The
 7 effects of this command can be stacked.
 8 
 9 
10 Arguments:
11 path
12    is the pathname of a segment.  If the segment does not exist, it is
13    created.  If you give no path, the segment output_file in your
14    working directory is assumed.
15 
16 
17 Control arguments:
18 -extend
19    extends the output file.  (Default)
20 -source_switch STR, -ssw STR
21    specifies the name of an I/O switch to be redirected.  (Default:
22    user_output)
23 -truncate, -tc
24    truncates an existing output file for file_output.  (Default: to
25    extend the output file)
26 
27 
28 Notes: Each command invocation of file_output stacks up another
29 attachment for each of the specified switches.
30 
31 See the revert_output, syn_output, and terminal_output commands.