docs: mention long options in man uptime.1

The commit includes few generic manual clean ups as well.

Signed-off-by: Sami Kerola <kerolasa@iki.fi>
This commit is contained in:
Sami Kerola 2011-06-06 22:44:05 +02:00
parent 97b08249c6
commit c1b3c819b0

View File

@ -1,32 +1,35 @@
.\" -*-Nroff-*- .\" -*-Nroff-*-
.\" .\"
.TH UPTIME 1 "26 Jan 1993" "Cohesive Systems" "Linux User's Manual" .TH UPTIME "1" "June 2011" "procps-ng" "User Commands"
.SH NAME .SH NAME
uptime \- Tell how long the system has been running. uptime \- Tell how long the system has been running.
.SH SYNOPSIS .SH SYNOPSIS
.B uptime .B uptime
.br [\fIoptions\fR]
.B uptime
.RB [ \-V ]
.SH DESCRIPTION .SH DESCRIPTION
.B uptime .B uptime
gives a one line display of the following information. gives a one line display of the following information. The current time, how
The current time, long the system has been running, how many users are currently logged on, and
how long the system has been running, the system load averages for the past 1, 5, and 15 minutes.
how many users are currently logged on, .PP
and the system load averages for the past 1, 5, and 15 minutes.
This is the same information contained in the header line displayed by This is the same information contained in the header line displayed by
.BR w (1). .BR w (1).
.sp .PP
System load averages is the average number of processes that are either System load averages is the average number of processes that are either in a
in a runnable or uninterruptable state. A process in a runnable state is runnable or uninterruptable state. A process in a runnable state is either
either using the CPU or waiting to use the CPU. A process in using the CPU or waiting to use the CPU. A process in uninterruptable state
uninterruptable state is waiting for some I/O access, eg waiting for is waiting for some I/O access, eg waiting for disk. The averages are taken
disk. The averages are taken over the three time intervals. over the three time intervals. Load averages are not normalized for the
Load averages are not normalized for the number of CPUs in a system, so number of CPUs in a system, so a load average of 1 means a single CPU system
a load average of 1 means a single CPU system is loaded all the time is loaded all the time while on a 4 CPU system it means it was idle 75% of
while on a 4 CPU system it means it was idle 75% of the time. the time.
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
display this help text
.TP
\fB\-V\fR, \fB\-\-version\fR
display version information and exit
.SH FILES .SH FILES
.TP .TP
.I /var/run/utmp .I /var/run/utmp
@ -36,12 +39,20 @@ information about who is currently logged on
process information process information
.SH AUTHORS .SH AUTHORS
.B uptime .B uptime
was written by Larry Greenfield <greenfie@gauss.rutgers.edu> and was written by
Michael K. Johnson <johnsonm@sunsite.unc.edu>. .UR greenfie\@gauss.\:rutgers.\:edu
Larry Greenfield
Please send bug reports to <procps@freelists.org> .UE
and
.UR johnsonm\@sunsite.\:unc.\:edu
Michael K. Johnson
.UE
.SH "SEE ALSO" .SH "SEE ALSO"
.BR ps (1), .BR ps (1),
.BR top (1), .BR top (1),
.BR utmp (5), .BR utmp (5),
.BR w (1) .BR w (1)
.SH "REPORTING BUGS"
Please send bug reports to
.UR procps\@freelists.org
.UE