[src/trunk]: src/share/man/man9 Elaborate comment before pserialize_perform.

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

details:   https://anonhg.NetBSD.org/src/rev/33a00e4f64fe
branches:  trunk
changeset: 333905:33a00e4f64fe
user:      riastradh <riastradh%NetBSD.org@localhost>
date:      Fri Nov 21 15:44:42 2014 +0000

description:
Elaborate comment before pserialize_perform.

diffstat:

 share/man/man9/pserialize.9 |  7 +++++--
 1 files changed, 5 insertions(+), 2 deletions(-)

diffs (21 lines):

diff -r 547d0001f1b8 -r 33a00e4f64fe share/man/man9/pserialize.9
--- a/share/man/man9/pserialize.9       Fri Nov 21 15:42:57 2014 +0000
+++ b/share/man/man9/pserialize.9       Fri Nov 21 15:44:42 2014 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: pserialize.9,v 1.6 2014/11/21 15:42:57 riastradh Exp $
+.\"    $NetBSD: pserialize.9,v 1.7 2014/11/21 15:44:42 riastradh Exp $
 .\"
 .\" Copyright (c) 2011 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -142,7 +142,10 @@
                        break;
                }
        }
-       /* Wait for all existing readers to drain.  */
+       /*
+        * Wait for all existing readers to complete.  New readers will
+        * not see f because the list no longer points to it.
+        */
        pserialize_perform(frobbotzim_psz);
        /* Now nobody else can be touching f, so it is safe to free.  */
        mutex_exit(\*[Am]frobbotzim_lock);