[src/trunk]: src/share/man/man9 Clarify wording about when to use PSLIST_ENTR...

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

details:   https://anonhg.NetBSD.org/src/rev/510c21796b87
branches:  trunk
changeset: 344693:510c21796b87
user:      riastradh <riastradh%NetBSD.org@localhost>
date:      Mon Apr 11 13:45:20 2016 +0000

description:
Clarify wording about when to use PSLIST_ENTRY_DESTROY.

diffstat:

 share/man/man9/pslist.9 |  9 ++++-----
 1 files changed, 4 insertions(+), 5 deletions(-)

diffs (24 lines):

diff -r 51df2dc55887 -r 510c21796b87 share/man/man9/pslist.9
--- a/share/man/man9/pslist.9   Mon Apr 11 13:18:13 2016 +0000
+++ b/share/man/man9/pslist.9   Mon Apr 11 13:45:20 2016 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: pslist.9,v 1.14 2016/04/11 03:27:14 riastradh Exp $
+.\"    $NetBSD: pslist.9,v 1.15 2016/04/11 13:45:20 riastradh Exp $
 .\"
 .\" Copyright (c) 2016 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -121,11 +121,10 @@
 reading the next entry.
 The caller must then wait, e.g. with
 .Xr pserialize_perform 9 ,
-for all extant parallel readers to finish, before freeing or reusing
-the list entry.
-A list entry should be destroyed with
+for all extant parallel readers to finish, before destroying the list
+entry with
 .Fn PSLIST_ENTRY_DESTROY
-before it may be reused.
+and then freeing or reusing its memory.
 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .Sh EXCLUSIVE OPERATIONS
 The following operations may be performed on list heads and entries