Index: stable/12/lib/msun/man/sqrt.3
===================================================================
--- stable/12/lib/msun/man/sqrt.3	(revision 358478)
+++ stable/12/lib/msun/man/sqrt.3	(revision 358479)
@@ -1,122 +1,125 @@
 .\" Copyright (c) 1985, 1991 Regents of the University of California.
 .\" All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
 .\" 3. Neither the name of the University nor the names of its contributors
 .\"    may be used to endorse or promote products derived from this software
 .\"    without specific prior written permission.
 .\"
 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
 .\"     from: @(#)sqrt.3	6.4 (Berkeley) 5/6/91
 .\" $FreeBSD$
 .\"
-.Dd March 5, 2011
+.Dd February 15, 2020
 .Dt SQRT 3
 .Os
 .Sh NAME
 .Nm cbrt ,
 .Nm cbrtf ,
 .Nm cbrtl ,
 .Nm sqrt ,
 .Nm sqrtf ,
 .Nm sqrtl
 .Nd cube root and square root functions
 .Sh LIBRARY
 .Lb libm
 .Sh SYNOPSIS
 .In math.h
 .Ft double
 .Fn cbrt "double x"
 .Ft float
 .Fn cbrtf "float x"
 .Ft long double
 .Fn cbrtl "long double x"
 .Ft double
 .Fn sqrt "double x"
 .Ft float
 .Fn sqrtf "float x"
 .Ft long double
 .Fn sqrtl "long double x"
 .Sh DESCRIPTION
 The
 .Fn cbrt ,
 .Fn cbrtf ,
 and
 .Fn cbrtl
 functions compute
 the cube root of
 .Ar x .
 .Pp
 The
 .Fn sqrt ,
 .Fn sqrtf ,
 and
 .Fn sqrtl
 functions compute the
 non-negative square root of
 .Ar x .
 .Sh RETURN VALUES
 The
 .Fn cbrt ,
 .Fn cbrtf ,
 and
 .Fn cbrtl
 functions return the requested cube root.
 The
 .Fn sqrt ,
 .Fn sqrtf ,
 and
 .Fn sqrtl
 functions return the requested square root
 unless an error occurs.
 An attempt to take the
 .Fn sqrt
 of negative
 .Fa x
 raises an invalid exception and causes an \*(Na to be returned
 (except that the square root of -0 is valid and equal to -0.)
 .Sh SEE ALSO
 .Xr fenv 3 ,
 .Xr math 3
 .Sh STANDARDS
 The
 .Fn cbrt ,
 .Fn cbrtf ,
 .Fn cbrtl ,
 .Fn sqrt ,
 .Fn sqrtf ,
 and
 .Fn sqrtl
 functions conform to
 .St -isoC-99 .
 .Sh HISTORY
 The
 .Fn cbrt
 function appeared in
 .Bx 4.3 .
 The
+.Fn sqrt
+function appeared in
+.At v2 .
 .Fn sqrtl
 function appeared in
 .Fx 8.0 .
 The
 .Fn cbrtl
 function appeared in
 .Fx 9.0 .
Index: stable/12/share/man/man7/environ.7
===================================================================
--- stable/12/share/man/man7/environ.7	(revision 358478)
+++ stable/12/share/man/man7/environ.7	(revision 358479)
@@ -1,264 +1,264 @@
 .\" Copyright (c) 1983, 1990, 1993
 .\"	The Regents of the University of California.  All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
 .\" 3. Neither the name of the University nor the names of its contributors
 .\"    may be used to endorse or promote products derived from this software
 .\"    without specific prior written permission.
 .\"
 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
 .\"	@(#)environ.7	8.3 (Berkeley) 4/19/94
 .\" $FreeBSD$
 .\"
-.Dd April 12, 2003
+.Dd February 14, 2020
 .Dt ENVIRON 7
 .Os
 .Sh NAME
 .Nm environ
 .Nd user environment
 .Sh SYNOPSIS
 .Ar extern char **environ ;
 .Sh DESCRIPTION
 An array of strings called the
 .Ar environment
 is made available by
 .Xr execve 2
 when a process begins.
 By convention these strings have the form
 .Dq Ar name=value .
 The following names are used by various commands:
 .Bl -tag -width LC_MONETARY
 .It Ev BLOCKSIZE
 The size of the block units used by several commands, most notably
 .Xr df 1 ,
 .Xr du 1
 and
 .Xr ls 1 .
 This variable is processed by the
 .Xr getbsize 3
 function.
 .It Ev COLUMNS
 The user's preferred width in column positions for the terminal.
 Utilities such as
 .Xr ls 1
 and
 .Xr who 1
 use this to format output into columns.
 If unset or empty, utilities will use an
 .Xr ioctl 2
 call to ask the terminal driver for the width.
 .It Ev EDITOR
 Default editor name.
 .It Ev EXINIT
 A startup list of commands read by
 .Xr ex 1
 and
 .Xr vi 1 .
 .It Ev HOME
 A user's login directory, set by
 .Xr login 1
 from the password file
 .Xr passwd 5 .
 .It Ev LANG
 This variable configures all programs which use
 .Xr setlocale 3
 to use the specified locale unless the
 .Ev LC_*
 variables are set.
 .It Ev LC_ALL
 Overrides the values of
 .Ev LC_COLLATE ,
 .Ev LC_CTYPE ,
 .Ev LC_MESSAGES ,
 .Ev LC_MONETARY ,
 .Ev LC_NUMERIC ,
 .Ev LC_TIME
 and
 .Ev LANG .
 .It Ev LC_COLLATE
 Locale to be used for ordering of strings.
 .It Ev LC_CTYPE
 Locale to be used for character classification
 (letter, space, digit, etc.) and for interpreting byte sequences as
 multibyte characters.
 .It Ev LC_MESSAGES
 Locale to be used for diagnostic messages.
 .It Ev LC_MONETARY
 Locale to be used for interpreting monetary input
 and formatting output.
 .It Ev LC_NUMERIC
 Locale to be used for interpreting numeric input and
 formatting output.
 .It Ev LC_TIME
 Locale to be used for interpreting dates input and
 for formatting output.
 .It Ev MAIL
 The location of the user's
 mailbox instead of the default in /var/mail,
 used by
 .Xr mail 1 ,
 .Xr sh 1 ,
 and many other mail clients.
 .It Ev NLSPATH
 List of directories to be searched for the message catalog referred to by
 .Ev LC_MESSAGES .
 See
 .Xr catopen 3 .
 .It Ev PAGER
 Default paginator program.
 The program specified by this variable is used by
 .Xr mail 1 ,
 .Xr man 1 ,
 .Xr ftp 1 ,
 etc, to display information which is longer than the current display.
 .It Ev PATH
 The sequence of directories, separated by colons, searched by
 .Xr csh 1 ,
 .Xr sh 1 ,
 .Xr system 3 ,
 .Xr execvp 3 ,
 etc, when looking for an executable file.
 .Ev PATH
 is set to ``/usr/bin:/bin'' initially by
 .Xr login 1 .
 .It Ev PRINTER
 The name of the default printer to be used by
 .Xr lpr 1 ,
 .Xr lpq 1 ,
 and
 .Xr lprm 1 .
 .It Ev PWD
 The current directory pathname.
 .It Ev SHELL
 The full pathname of the user's login shell.
 .It Ev TERM
 The kind of terminal for which output is to be prepared.
 This information is used by commands, such as
 .Xr nroff 1
 or
 .Xr plot 1
 which may exploit special terminal capabilities.
 See
 .Pa /usr/share/misc/termcap
 .Pq Xr termcap 5
 for a list of terminal types.
 .It Ev TERMCAP
 The string describing the terminal in
 .Ev TERM ,
 or, if
 it begins with a '/', the name of the termcap file.
 See
 .Ev TERMPATH
 below, and
 .Xr termcap 5 .
 .It Ev TERMPATH
 A sequence of pathnames of termcap files, separated by colons or spaces,
 which are searched for terminal descriptions in the order listed.
 Having
 no
 .Ev TERMPATH
 is equivalent to a
 .Ev TERMPATH
 of
 .Dq Pa $HOME/.termcap:/etc/termcap .
 .Ev TERMPATH
 is ignored if
 .Ev TERMCAP
 contains a full pathname.
 .It Ev TMPDIR
 The directory in which to store temporary files.
 Most applications use either
 .Dq /tmp
 or
 .Dq /var/tmp .
 Setting this variable will make them use another directory.
 .It Ev TZ
 The timezone to use when displaying dates.
 The normal format is a pathname relative to
 .Dq Pa /usr/share/zoneinfo .
 For example, the command
 .Dq env TZ=America/Los_Angeles date
 displays the current time in California.
 See
 .Xr tzset 3
 for more information.
 .It Ev USER
 The login name of the user.
 .El
 .Pp
 Further names may be placed in the environment by the
 .Ic export
 command and
 .Ar name=value
 arguments in
 .Xr sh 1 ,
 or by the
 .Ic setenv
 command if you use
 .Xr csh 1 .
 It is unwise to change certain
 .Xr sh 1
 variables that are frequently exported by
 .Pa .profile
 files, such as
 .Ev MAIL ,
 .Ev PS1 ,
 .Ev PS2 ,
 and
 .Ev IFS ,
 unless you know what you are doing.
 .Pp
 The current environment variables can be printed with
 .Xr env 1 ,
 .Xr set 1
 or
 .Xr printenv 1
 in
 .Xr sh 1
 and
 .Xr env 1 ,
 .Xr printenv 1
 or the
 .Cm printenv
 built-in command in
 .Xr csh 1 .
 .Sh SEE ALSO
 .Xr cd 1 ,
 .Xr csh 1 ,
 .Xr env 1 ,
 .Xr ex 1 ,
 .Xr login 1 ,
 .Xr printenv 1 ,
 .Xr sh 1 ,
 .Xr execve 2 ,
 .Xr execle 3 ,
 .Xr getbsize 3 ,
 .Xr getenv 3 ,
 .Xr setenv 3 ,
 .Xr setlocale 3 ,
 .Xr system 3 ,
 .Xr termcap 3 ,
 .Xr termcap 5
 .Sh HISTORY
 The
 .Nm
 manual page appeared in
-.Bx 4.2 .
+.At v7 .
Index: stable/12/usr.sbin/ac/ac.8
===================================================================
--- stable/12/usr.sbin/ac/ac.8	(revision 358478)
+++ stable/12/usr.sbin/ac/ac.8	(revision 358479)
@@ -1,148 +1,158 @@
 .\"
 .\" Copyright (c) 1994 Simon J. Gerraty
 .\" Copyright (c) 1994 Christopher G. Demetriou
 .\" All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
 .\"
 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
 .\" $FreeBSD$
 .\"
-.Dd January 21, 2010
+.Dd February 14, 2020
 .Dt AC 8
 .Os
 .Sh NAME
 .Nm ac
 .Nd connect time accounting
 .Sh SYNOPSIS
 .Nm
 .Op Fl dp
 .\".Op Fl c Ar console
 .Op Fl t Ar tty
 .Op Fl w Ar wtmp
 .Op Ar users ...
 .Sh DESCRIPTION
 If the file
 .Pa /var/log/utx.log
 exists, a record of individual login and logout
 times are written to it by
 .Xr login 1
 and
 .Xr init 8 ,
 respectively.
 The
 .Nm
 utility
 examines these records and writes the accumulated connect time (in hours)
 for all logins to the standard output.
 .Pp
 The options are as follows:
 .Bl -tag -width indentXXX
 .It Fl d
 Display the connect times in 24 hour chunks.
 .\" .It Fl c Ar console
 .\" Use
 .\" .Ar console
 .\" as the name of the device that local X sessions (ut_host of ":0.0")
 .\" originate from.  If any login has been recorded on
 .\" .Ar console
 .\" then these X sessions are ignored unless COMPAT_SUNOS was defined at
 .\" compile time.
 .It Fl p
 Print individual users' totals.
 .It Fl t Ar tty
 Only do accounting logins on certain ttys.
 The
 .Ar tty
 specification can start with '!' to indicate not this
 .Ar tty
 and end with '*' to indicate all similarly named ttys.
 Multiple
 .Fl t
 flags may be specified.
 .It Fl w Ar wtmp
 Read connect time data from
 .Ar wtmp
 instead of the default file,
 .Pa /var/log/utx.log .
 .It Ar users ...
 Display totals for the given individuals only.
 .El
 .Pp
 If no arguments are given,
 .Nm
 displays the total connect time for all
 accounts with login sessions recorded in
 .Pa utx.log .
 .Pp
 The default
 .Pa utx.log
 file will increase without bound unless it is truncated.
 It is normally truncated by the daily scripts run
 by
 .Xr cron 8 ,
 which rename and rotate the
 .Pa utx.log
 files, keeping a week's worth of data on
 hand.
 No login or connect time accounting is performed if
 .Pa /var/log/utx.log
 does not exist.
 .Sh FILES
 .Bl -tag -width /var/log/utx.log -compact
 .It Pa /var/log/utx.log
 connect time accounting file
 .El
 .Sh EXIT STATUS
 .Ex -std
 .Sh EXAMPLES
 Allow times recorded in
 .Pa modems
 to be charged out at a different rate than
 .Pa other :
 .Bd -literal -offset indent
 ac -p -t "ttyd*" > modems
 ac -p -t "!ttyd*" > other
 .Ed
 .Sh SEE ALSO
 .Xr login 1 ,
 .Xr getutxent 3 ,
 .Xr init 8 ,
 .Xr sa 8
+.Sh HISTORY
+An
+.Nm
+command appeared in
+.At v5 .
+This version of
+.Nm
+was written for
+.Nx 0.9a
+from the specification provided by various systems' manual pages.
 .\" .Sh NOTES
 .\" If COMPAT_SUNOS is defined
 .\" .Nm ac
 .\" ignores the fact that entries with ut_host of ":0.0" are not real
 .\" login sessions.  Normally such entries are ignored except in the case
 .\" of a user being logged in when the
 .\" .Pa wtmp
 .\" file was rotated, in which case a login with ut_host of ":0.0" may
 .\" appear without any preceding console logins.
 .\" If no one is logged in on the console, the user is deemed to have
 .\" logged in on at the earliest time stamp found in
 .\" .Pa wtmp .
 .\" Use of
 .\" .Pa console
 .\" allows
 .\" .Nm ac
 .\" to identify and correctly process a logout for the user.  The default
 .\" value for
 .\" .Pa console
 .\" is usually correct at compile time.
Index: stable/12/usr.sbin/sa/sa.8
===================================================================
--- stable/12/usr.sbin/sa/sa.8	(revision 358478)
+++ stable/12/usr.sbin/sa/sa.8	(revision 358479)
@@ -1,262 +1,270 @@
 .\"
 .\" Copyright (c) 1994 Christopher G. Demetriou
 .\" All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
 .\" 3. All advertising materials mentioning features or use of this software
 .\"    must display the following acknowledgement:
 .\"      This product includes software developed by Christopher G. Demetriou.
 .\" 3. The name of the author may not be used to endorse or promote products
 .\"    derived from this software without specific prior written permission
 .\"
 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
 .\" $FreeBSD$
 .\"
-.Dd May 18, 2007
+.Dd February 14, 2020
 .Dt SA 8
 .Os
 .Sh NAME
 .Nm sa
 .Nd print system accounting statistics
 .Sh SYNOPSIS
 .Nm
 .Op Fl abcdDfijkKlmnqrstu
 .Op Fl P Ar file
 .Op Fl U Ar file
 .Op Fl v Ar cutoff
 .Op Ar
 .Sh DESCRIPTION
 The
 .Nm
 utility reports on, cleans up,
 and generally maintains system
 accounting files.
 .Pp
 The
 .Nm
 utility is able to condense the information in
 .Pa /var/account/acct
 into the summary files
 .Pa /var/account/savacct
 and
 .Pa /var/account/usracct ,
 which contain system statistics according
 to command name and login id, respectively.
 This condensation is desirable because on a
 large system,
 .Pa /var/account/acct
 can grow by hundreds of blocks per day.
 The summary files are normally read before
 the accounting file, so that reports include
 all available information.
 .Pp
 If file names are supplied, they are read instead of
 .Pa /var/account/acct .
 After each file is read, if the summary
 files are being updated, an updated summary will
 be saved to disk.
 Only one report is printed,
 after the last file is processed.
 .Pp
 The labels used in the output indicate the following, except
 where otherwise specified by individual options:
 .Bl -tag -width k*sec
 .It Dv avio
 Average number of I/O operations per execution
 .It Dv cp
 Sum of user and system time, in minutes
 .It Dv cpu
 Same as
 .Dv cp
 .It Dv k
 CPU-time averaged core usage, in 1k units
 .It Dv k*sec
 CPU storage integral, in 1k-core seconds
 .It Dv re
 Real time, in minutes
 .It Dv s
 System time, in minutes
 .It Dv tio
 Total number of I/O operations
 .It Dv u
 User time, in minutes
 .El
 .Pp
 The options to
 .Nm
 are:
 .Bl -tag -width Ds
 .It Fl a
 List all command names, including those containing unprintable
 characters and those used only once.
 By default,
 .Nm
 places all names containing unprintable characters and
 those used only once under the name ``***other''.
 .It Fl b
 If printing command statistics, sort output by the sum of user and system
 time divided by number of calls.
 .It Fl c
 In addition to the number of calls and the user, system and real times
 for each command, print their percentage of the total over all commands.
 .It Fl d
 If printing command statistics, sort by the average number of disk
 I/O operations.
 If printing user statistics, print the average number of
 disk I/O operations per user.
 .It Fl D
 If printing command statistics, sort and print by the total number
 of disk I/O operations.
 .It Fl f
 Force no interactive threshold comparison with the
 .Fl v
 option.
 .It Fl i
 Do not read in the summary files.
 .It Fl j
 Instead of the total minutes per category, give seconds per call.
 .It Fl k
 If printing command statistics, sort by the cpu-time average memory
 usage.
 If printing user statistics, print the cpu-time average
 memory usage.
 .It Fl K
 If printing command statistics, print and sort by the cpu-storage integral.
 .It Fl l
 Separate system and user time; normally they are combined.
 .It Fl m
 Print per-user statistics rather than per-command statistics.
 .It Fl n
 Sort by number of calls.
 .It Fl P Ar file
 Use the specified
 .Ar file
 for accessing the per-command accounting summary database,
 instead of the default
 .Pa /var/account/savacct .
 .It Fl q
 Create no output other than error messages.
 .It Fl r
 Reverse order of sort.
 .It Fl s
 Truncate the accounting files when done and merge their data
 into the summary files.
 .It Fl t
 For each command, report the ratio of real time to the sum
 of user and system cpu times.
 If the cpu time is too small to report, ``*ignore*'' appears in
 this field.
 .It Fl U Ar file
 Use the specified
 .Ar file
 for accessing the per-user accounting summary database,
 instead of the default
 .Pa /var/account/usracct .
 .It Fl u
 Superseding all other flags, for each entry
 in the accounting file, print the user ID, total seconds of cpu usage,
 total memory usage, number of I/O operations performed, and
 command name.
 .It Fl v Ar cutoff
 For each command used
 .Ar cutoff
 times or fewer, print the command name and await a reply
 from the terminal.
 If the reply begins with ``y'', add
 the command to the category ``**junk**''.
 This flag is
 used to strip garbage from the report.
 .El
 .Pp
 By default, per-command statistics will be printed.
 The number of
 calls, the total elapsed time in minutes, total cpu and user time
 in minutes, average number of I/O operations, and CPU-time
 averaged core usage will be printed.
 If the
 .Fl m
 option is specified, per-user statistics will be printed, including
 the user name, the number of commands invoked, total cpu time used
 (in minutes), total number of I/O operations, and CPU storage integral
 for each user.
 If the
 .Fl u
 option is specified, the uid, user and system time (in seconds),
 CPU storage integral, I/O usage, and command name will be printed
 for each entry in the accounting data file.
 .Pp
 If the
 .Fl u
 flag is specified, all flags other than
 .Fl q
 are ignored.
 If the
 .Fl m
 flag is specified, only the
 .Fl b ,
 .Fl d ,
 .Fl i ,
 .Fl k ,
 .Fl q ,
 and
 .Fl s
 flags are honored.
 .Sh FILES
 .Bl -tag -width /var/account/usracct -compact
 .It Pa /var/account/acct
 raw accounting data file
 .It Pa /var/account/savacct
 per-command accounting summary database
 .It Pa /var/account/usracct
 per-user accounting summary database
 .El
 .Sh EXIT STATUS
 .Ex -std
 .Sh SEE ALSO
 .Xr lastcomm 1 ,
 .Xr acct 5 ,
 .Xr ac 8 ,
 .Xr accton 8
+.Sh HISTORY
+.Nm
+first appeared in
+.At v5 .
+.Nm
+was rewritten for
+.Nx 0.9a
+from the specification provided by various systems' manual pages.
 .Sh AUTHORS
 .An Chris G. Demetriou Aq Mt cgd@postgres.berkeley.edu
 .Sh CAVEATS
 While the behavior of the options in this version of
 .Nm
 was modeled after the original version, there are some intentional
 differences and undoubtedly some unintentional ones as well.
 In
 particular, the
 .Fl q
 option has been added, and the
 .Fl m
 option now understands more options than it used to.
 .Pp
 The formats of the summary files created by this version of
 .Nm
 are very different from the those used by the original version.
 This is not considered a problem, however, because the accounting record
 format has changed as well (since user ids are now 32 bits).
 .Sh BUGS
 The number of options to this program is absurd, especially considering
 that there is not much logic behind their lettering.
 .Pp
 The field labels should be more consistent.
 .Pp
 The VM system does not record the CPU storage integral.
Index: stable/12
===================================================================
--- stable/12	(revision 358478)
+++ stable/12	(revision 358479)

Property changes on: stable/12
___________________________________________________________________
Modified: svn:mergeinfo
## -0,0 +0,1 ##
   Merged /head:r358099