1 :Info: attach_audit.changes:  1981-03-20  Summary description of the new audit facility.
 2 
 3 There are many changed aspects of audit in this version.
 4 There are bug fixes, additional features, and some incompatible
 5 interface changes.  The audit file format is unchanged however, so old
 6 audit files may be used with the new audit.
 7 
 8 
 9 New attach_audit:
10 
11      Additional control argument, -modes, allows you to specify the
12 modes to be set on the switch being audited, usually user_i/o, without
13 entering a separate input line.  It takes a mode string as an
14 argument.
15 
16 
17 New audit request:
18 
19     There is one new audit request, !d, and one changed request, !n.
20 These are going to work as originally documented.  !n used to delete
21 the line, as though nothing had been typed, now it is simply stripped
22 from the line.  This new function for !n is useful when you want to
23 end a line with what would otherwise be interpreted as an audit
24 request.  Unrecognized requests will now be audited.  Due to a bug in
25 the audit request processing, when audit saw a line that ended in the
26 magic sequence, <trigger character><any character><new line>, which
27 didn't have a recognized request in it, it simply passed the line on
28 without logging it.
29 
30 
31 New audit editor:
32 
33     The editor now prompts, by default, with the string "audit
34 editor:" or "audit editor (level <level number>):" when <level number>
35 is greater than 1.  The level is the depth of recursive invocations of
36 the audit editor.  There are three new audit modes to deal with the
37 prompting, audit_use_editor_prompt for turning it on and off,
38 audit_editor_prompt_string=<string> for setting the string.  The
39 string is an ioa_ control string with the first argument being a bit
40 which is on if the level is greater than 1, and the second argument is
41 the level.  The default control string is:
42 "^/audit editor^[(^d)^]:^2x".
43 
44 
45 All of the requests which are of the form .<character> now have
46 "short" names of <character>, the exception to this is ".." which
47 remains unchanged.  There is now an "=" request which prints the
48 current entry number.  This entry number is as understood by the audit
49 editor, which only counts entries matching the default entry tag, or
50 class identifier.  Hence, by changing the default tag with the ":"
51 request or the "d" request the current line number can change.
52 
53 
54 New display_audit_file:
55 
56     Daf takes a new argument, -output_file or -of.  There are four new
57 control arguments for controlling output format: -insert_nl,
58 -no_insert_nl, -append_nl and -no_append_nl.  In the absence of any of
59 these arguments, daf decides whether or not to insert or append
60 newlines based on the presence of a leader (forced by -etn, -cli, or
61 -mt) and the length of the output line (set by -ll explicitly or by a
62 get_line_length_ on the output switch).  Newline insertion is done to
63 prevent lines from wrapping on the terminal, and to keep the leftmost
64 columns free of all characters except leader information.  Newline
65 appending is done to insure that printing of an entry always begins at
66 the left margin, this is necessary when an entry in the audit file
67 doesn't end in a newline.
68 
69 
70 :hcom:
71 /****^  HISTORY COMMENTS:
72   1) change(2020-12-15,GDixon), approve(2021-02-22,MCR10088),
73      audit(2021-05-27,Swenson), install(2021-05-27,MR12.6g-0056):
74       A) Fix errors reported by the new verify_info command.
75                                                    END HISTORY COMMENTS */