.BG
.FN TRUNC_AUDIT
.TL
Truncate the Audit File
.CS
S TRUNC_AUDIT size
.AG size
desired size of the resulting `.Data/.Audit' file.
Default is 100000 characters.
.PP
The `TRUNC_AUDIT' utility attempts to preserve
the most recent `size' characters of the audit file.
It does so by finding the first S expression in the
audit file that is within `size' characters of the end of file.
.PP
If there is a problem in truncating the audit file, a message
is produced and the audit file is not changed.
If you get a warning, it may be an indication that the audit
file has been corrupted.
.PP
Whenever S is started, one of the first things that it does is check
the size of the audit file against the `audit_size' limit.
If it is over the limit, a message is printed advising you to use
the `TRUNC_AUDIT' utility.
If your audit file contains important information, do not run
`TRUNC_AUDIT', but instead increase the `audit.size' option.
Executing
.Cs
\&.Options$audit.size <- x
.Ce
will cause S to use `x' as
the audit file size limit.
.SH WARNING
The `TRUNC_AUDIT' utility cannot be run from inside S,
since S normally has the audit file open for writing.
.EX
S TRUNC_AUDIT 0   # clear out the audit file
.KW utilities
.WR
