===================================================================
RCS file: /cvsrepo/anoncvs/cvs/src/usr.bin/renice/renice.8,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- src/usr.bin/renice/renice.8	2007/05/31 19:20:15	1.17
+++ src/usr.bin/renice/renice.8	2008/12/08 21:23:10	1.18
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: renice.8,v 1.17 2007/05/31 19:20:15 jmc Exp $
+.\"	$OpenBSD: renice.8,v 1.18 2008/12/08 21:23:10 millert Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"     from: @(#)renice.8	8.1 (Berkeley) 6/9/93
 .\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: December 8 2008 $
 .Dt RENICE 8
 .Os
 .Sh NAME
@@ -37,7 +37,7 @@
 .Nd alter priority of running processes
 .Sh SYNOPSIS
 .Nm renice
-.Ar priority
+.Fl n Ar increment
 .Oo
 .Op Fl g
 .Ar pgrp ...
@@ -52,9 +52,8 @@
 .Oc
 .Sh DESCRIPTION
 .Nm
-alters the scheduling
-.Em priority
-of one or more running processes.
+alters the scheduling priority of one or more running processes by
+.Ar increment .
 Processes may be selected using the parameters
 .Ar pid
 (process ID),
@@ -62,7 +61,7 @@
 (process group ID),
 and
 .Ar user
-(user name).
+(user name or ID).
 If no flag is specified,
 the default is to select by process ID.
 .Pp
@@ -95,12 +94,16 @@
 .It Fl g Ar pgrp
 Alter the scheduling priority of all processes in process group
 .Ar pgrp .
+.It Fl n Ar increment
+A positive or negative decimal integer used to modify the
+scheduling priority.
 .It Fl p Ar pid
 Alter the scheduling priority of process
 .Ar pid .
 .It Fl u Ar user
-Alter the scheduling priority of all processes belonging to user
-.Ar user .
+Alter the scheduling priority of all processes belonging to
+.Ar user ,
+which may be a user name or ID.
 .El
 .Sh FILES
 .Bl -tag -width /etc/passwd -compact
@@ -112,7 +115,7 @@
 changes the priority of process IDs 987 and 32,
 and all processes owned by users daemon and root:
 .Bd -literal -offset indent
-# renice +1 987 -u daemon root -p 32
+# renice -n +1 987 -u daemon root -p 32
 .Ed
 .Sh SEE ALSO
 .Xr nice 1 ,
@@ -125,6 +128,9 @@
 .St -p1003.1-2004
 specification,
 but its presence is optional.
+.Pp
+The historical behavior of passing the increment as the first
+argument is supported for backwards compatibility.
 .Pp
 The arguments to flags
 .Op Fl gpu