[src/pgoyette-localcount]: src/share/man/man9 Add a BUGS section, which is re...

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

details:   https://anonhg.NetBSD.org/src/rev/26c346211a52
branches:  pgoyette-localcount
changeset: 852894:26c346211a52
user:      pgoyette <pgoyette%NetBSD.org@localhost>
date:      Mon Aug 01 12:02:00 2016 +0000

description:
Add a BUGS section, which is really a RESTRICTIONS section (but mdoclint
doesn't like RESTRICTIONS!)

diffstat:

 share/man/man9/localcount.9 |  18 ++++++++++++++++--
 1 files changed, 16 insertions(+), 2 deletions(-)

diffs (36 lines):

diff -r c58001b388b9 -r 26c346211a52 share/man/man9/localcount.9
--- a/share/man/man9/localcount.9       Mon Aug 01 07:39:23 2016 +0000
+++ b/share/man/man9/localcount.9       Mon Aug 01 12:02:00 2016 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: localcount.9,v 1.1.2.4 2016/07/16 23:42:35 pgoyette Exp $
+.\"    $NetBSD: localcount.9,v 1.1.2.5 2016/08/01 12:02:00 pgoyette Exp $
 .\"
 .\" Copyright (c) 2016
 .\" 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 July xx, 2016
+.Dd August 2, 2016
 .Dt LOCALCOUNT 9
 .Os
 .Sh NAME
@@ -173,3 +173,17 @@
 .An Taylor R. Campbell .
 This manual page was compiled by
 .An Paul Goyette .
+.Sh BUGS
+The
+.Nm
+facility does not provide any way to examine the reference count without
+actually waiting for the count to reach zero.
+.Pp
+Waiting for a
+.Nm
+reference count to reach zero is a one-shot operation.
+Once the
+.Nm
+has been waited for, no further operations are allowed until the
+.Nm
+has been re-initialized.