[src/trunk]: src/share/man/man9 attempt to clarify bit about flags usage:

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

details:   https://anonhg.NetBSD.org/src/rev/213d53377b24
branches:  trunk
changeset: 559842:213d53377b24
user:      pooka <pooka%NetBSD.org@localhost>
date:      Wed Mar 24 17:44:22 2004 +0000

description:
attempt to clarify bit about flags usage:
  * remove mention to PR_URGENT, since it was removed from the code
    two years ago
  * mention PR_NOWAIT

diffstat:

 share/man/man9/pool.9 |  27 +++++++++------------------
 1 files changed, 9 insertions(+), 18 deletions(-)

diffs (61 lines):

diff -r 161a9b18c4b8 -r 213d53377b24 share/man/man9/pool.9
--- a/share/man/man9/pool.9     Wed Mar 24 17:40:02 2004 +0000
+++ b/share/man/man9/pool.9     Wed Mar 24 17:44:22 2004 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: pool.9,v 1.32 2004/03/08 23:02:40 wiz Exp $
+.\"    $NetBSD: pool.9,v 1.33 2004/03/24 17:44:22 pooka Exp $
 .\"
 .\" Copyright (c) 1997, 1998 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -34,7 +34,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd March 9, 2004
+.Dd March 24, 2004
 .Dt POOL 9
 .Os
 .Sh NAME
@@ -135,27 +135,18 @@
 .It Fa pp
 The handle identifying the pool resource instance.
 .It Fa flags
-One or more of
-.Dv PR_URGENT ,
-.Dv PR_WAITOK
-or
-.Dv PR_LIMITFAIL ,
-that define behaviour in case the pooled resources are depleted.
+The flags can be used to define behaviour in case the pooled resources
+are depleted.
 If no resources are available and
-.Dv PR_WAITOK
+.Dv PR_NOWAIT
 is given,
-this function will wait until items are returned to the pool.
-Otherwise
 .Fn pool_get
 returns
 .Dv NULL .
 If
-.Dv PR_URGENT
-is specified and no items are available and
-.Fn palloc
-cannot allocate a new page,
-the system will panic
-.Pq XXX .
+.Dv PR_WAITOK
+is given and allocation is attempted with no resources available,
+the function will sleep until items are returned to the pool.
 .\"Undefined behaviour results if
 .\".Dv PR_MALLOCOK
 .\"is specified on a pool handle that was created using client-provided
@@ -165,7 +156,7 @@
 .Dv PR_LIMITFAIL
 and
 .Dv PR_WAITOK
-is specified, and the pool has reached its hard limit,
+are specified, and the pool has reached its hard limit,
 .Fn pool_get
 will return
 .Dv NULL