1 12/01/86   save_format_options, svfo
 2 
 3 Syntax:  svfo path {-format_option_args} {-control_args}
 4 
 5 
 6 Function:  saves the current values of format options as a linus
 7 subsystem exec_com.  The saved format can be restored later with the
 8 restore_format_options request.  The file is saved with a suffix of
 9 ".fo.lec".  Individual format options; active format options; or all
10 the format options can be saved.  The selection expression can also be
11 saved.
12 
13 
14 Arguments:
15 path
16    the pathname of the segment which will contain the saved format.
17    The suffix ".fo.lec" is appended if not given.
18 
19 
20  Format Option Arguments
21 
22  Refer to the description of the set_format_options request for a
23  complete list of the names of the format option arguments.  Each format
24  option named will have its value saved in the exec_com specified by
25  path.  These arguments are incompatible with the control arguments
26  -all and -active listed below.
27 
28 
29 Control arguments:
30 -active, -act
31    specifies that only the active formatting options will be saved.
32    (DEFAULT) Type "help formatting_options.gi" for more information on
33    "active" formatting options.  This control argument is incompatible
34    with the format option arguments and "-all".
35 -all, -a
36    specifies that all formatting options should be saved.  This control
37    argument is incompatible with the format option arguments and
38    "-active".
39 -query
40    specifies that the current query should also be
41    saved.  A restore_format_options on the saved format will also
42    restore and process the saved selection expression.
43 
44 
45 Examples:
46 save_format_options report_layout
47 save_format_options report_layout -all
48 save_format_options report_layout -selection_expression
49 save_format_options report_layout -page_header_value -page_footer_value
50 save_format_options report_layout -page_header_value -width salary
51 save_format_options report_layout -width ** -page_footer_value
52