From d4e20cf95c1ca21b92e6ec39698234e06fd88660 Mon Sep 17 00:00:00 2001
From: dyoung <dyoung@NetBSD.org>
Date: Wed, 28 Jan 2009 23:44:45 +0000
Subject: [PATCH] Try to clarify what pset(3) actually does.  This needs some
 more work.

---
 lib/librt/pset.3 | 19 +++++++++++--------
 1 file changed, 11 insertions(+), 8 deletions(-)

diff --git a/lib/librt/pset.3 b/lib/librt/pset.3
index 64de2cee24d9..c319e3e53604 100644
--- a/lib/librt/pset.3
+++ b/lib/librt/pset.3
@@ -1,4 +1,4 @@
-.\"	$NetBSD: pset.3,v 1.8 2009/01/20 01:57:36 rmind Exp $
+.\"	$NetBSD: pset.3,v 1.9 2009/01/28 23:44:45 dyoung Exp $
 .\"
 .\" Copyright (c) 2008 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd October 18, 2008
+.Dd January 28, 2009
 .Dt PSET 3
 .Os
 .Sh NAME
@@ -47,8 +47,11 @@
 .Ft int
 .Fn pset_destroy "psetid_t psid"
 .Sh DESCRIPTION
-The processor sets API provides the possibility to bind processes or
-threads to specific processors or groups of processors.
+The processor sets API provides the possibility to exclusively
+dedicate specific processors or groups of processors to processes
+or threads.
+After processes or threads are bound to a group of processors by
+the API, the group henceforth runs only those processors or threads.
 This section describes the functions used to control processor sets.
 .Ss FUNCTIONS
 .Bl -tag -width compact
@@ -89,10 +92,10 @@ is set to
 .Dv PS_NONE ,
 any assignment to the processor will be cleared.
 .It Fn pset_bind psid type id opsid
-Binds the target specified by
-.Fa id
-to the processor set specified by
-.Fa psid .
+Dedicates the processor set specified by
+.Fa psid
+to the target specified by
+.Fa id .
 The current processor set ID to which the target is bound or
 .Dv PS_NONE
 will be returned in