[src/trunk]: src/lib/libc/sys - fix ambiguous sentences.

[yamt <yamt%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/fc0ae54edb7e
branches:  trunk
changeset: 778789:fc0ae54edb7e
user:      yamt <yamt%NetBSD.org@localhost>
date:      Fri Apr 13 15:14:27 2012 +0000

description:
- fix ambiguous sentences.
- mention scheduling class.

diffstat:

 lib/libc/sys/getpriority.2 |  17 ++++++++++++-----
 1 files changed, 12 insertions(+), 5 deletions(-)

diffs (63 lines):

diff -r c0232f8976ad -r fc0ae54edb7e lib/libc/sys/getpriority.2
--- a/lib/libc/sys/getpriority.2        Fri Apr 13 15:02:37 2012 +0000
+++ b/lib/libc/sys/getpriority.2        Fri Apr 13 15:14:27 2012 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: getpriority.2,v 1.18 2009/03/11 13:39:14 joerg Exp $
+.\"    $NetBSD: getpriority.2,v 1.19 2012/04/13 15:14:27 yamt Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"     @(#)getpriority.2      8.1 (Berkeley) 6/4/93
 .\"
-.Dd April 25, 2004
+.Dd April 13, 2012
 .Dt GETPRIORITY 2
 .Os
 .Sh NAME
@@ -55,6 +55,12 @@
 call and set with the
 .Fn setpriority
 call.
+.Pp
+The priority is maintained in a per-process basis and
+affects scheduling of LWPs which belong to the process and use the
+.Dv SCHED_OTHER
+scheduling class.
+.Pp
 .Fa which
 is one of
 .Dv PRIO_PROCESS ,
@@ -78,7 +84,7 @@
 .Fa prio
 is a value in the range -20 to 20.
 The default priority is 0;
-lower priorities cause more favorable scheduling.
+numerically lower priority values cause more favorable scheduling.
 A value of 19 or 20
 will schedule a process only when nothing at priority \*(Le 0 is runnable.
 .Pp
@@ -90,7 +96,7 @@
 .Fn setpriority
 call sets the priorities of all of the specified processes
 to the specified value.
-Only the super-user may lower priorities.
+Only the super-user may lower priority values.
 .Sh RETURN VALUES
 Since
 .Fn getpriority
@@ -133,11 +139,12 @@
 A process was located, but neither its effective nor real user
 ID matched the effective user ID of the caller.
 .It Bq Er EACCES
-A non super-user attempted to lower a process priority.
+A non super-user attempted to lower a process priority value.
 .El
 .Sh SEE ALSO
 .Xr nice 1 ,
 .Xr fork 2 ,
+.Xr sched 3 ,
 .Xr renice 8
 .Sh HISTORY
 The