[src/trunk]: src/share/man/man9 Fix wording around `list heads'.

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

details:   https://anonhg.NetBSD.org/src/rev/77f6dacde310
branches:  trunk
changeset: 344641:77f6dacde310
user:      riastradh <riastradh%NetBSD.org@localhost>
date:      Sat Apr 09 17:37:55 2016 +0000

description:
Fix wording around `list heads'.

A list head is not a list, conceptually.

diffstat:

 share/man/man9/pslist.9 |  14 ++++++++------
 1 files changed, 8 insertions(+), 6 deletions(-)

diffs (40 lines):

diff -r 0d86b51d1d5f -r 77f6dacde310 share/man/man9/pslist.9
--- a/share/man/man9/pslist.9   Sat Apr 09 17:34:57 2016 +0000
+++ b/share/man/man9/pslist.9   Sat Apr 09 17:37:55 2016 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: pslist.9,v 1.8 2016/04/09 17:34:57 riastradh Exp $
+.\"    $NetBSD: pslist.9,v 1.9 2016/04/09 17:37:55 riastradh Exp $
 .\"
 .\" Copyright (c) 2016 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -91,10 +91,12 @@
 or
 .Fn PSLIST_INIT
 before it may be used.
-When initialized, a list head is empty.
-A list head should be empty and destroyed with
+When initialized, a list head represents an empty list.
+A list should be empty and destroyed with
 .Fn PSLIST_DESTROY
-before its memory is reused.
+before the
+.Vt struct pslist_head
+object's memory is reused.
 .\"
 .Pp
 Each entry in a linked list is represented by a
@@ -137,12 +139,12 @@
 object.
 .\""""""""""""""""
 .It Fn PSLIST_INIT head
-Initialize the list head
+Initialize the list headed by
 .Fa head
 to be empty.
 .\""""""""""""""""
 .It Fn PSLIST_DESTROY head
-Destroy the list head
+Destroy the list headed by
 .Fa head ,
 which must be empty.
 .Pp