1 :Info: validate_info_seg: vis:  1985-10-10  validate_info_seg, vis
 2 
 3 Syntax as a command:  vis paths {-control_args}
 4 
 5 
 6 Syntax as an active function:  [vis paths {-control_args}]
 7 
 8 
 9 Function:  validates the syntax of an info segment.  The active
10 function returns the number of the highest severity error that
11 occurs.
12 
13 
14 Arguments:
15 paths
16    are the pathnames of info segs.  The info suffix need not be
17    supplied.  The star convention is allowed.
18 
19 
20 Control arguments:
21 -names, -nm
22    changes the names on the info segment, if necessary, to match the
23    names used in it.
24 -no_names, -nnm
25    does not change the names on the info segment to match the names
26    used in it, but merely reports discrepancies.  (Default)
27 -severity N, -sv N
28    suppresses error messages of severity less than N.
29 -total, -tt
30    prints only the total number of errors for each severity, or nothing
31    if there are no errors.
32 
33 
34 Notes on validation: The validate_info_seg (vis) command validates the
35 syntax of an info segment.  For a description of info segment format,
36 type "help info_seg.gi".  Error messages printed by vis are of four
37 severities:
38        Severity 4 -- bad errors precluding installation
39        Severity 3 -- less important errors
40        Severity 2 -- even less important errors
41        Severity 1 -- just warnings, such as the existence of
42                      nonstandard section headings.
43 
44 
45 :hcom:
46 
47 /****^  HISTORY COMMENTS:
48   1) change(2021-02-15,GDixon), approve(2021-02-15,MCR10085),
49      audit(2021-03-17,Swenson), install(2021-03-17,MR12.6g-0052):
50      As part of moving the validate_info_seg (vis) command from
51      bound_lib_utility_ to the new bound_old_help_ bound segment, add history
52      comments to its info segment.
53                                                    END HISTORY COMMENTS */