From 577cd717f614382e3c5441f14867b1fb207ad7d6 Mon Sep 17 00:00:00 2001
From: Sascha Wildner <saw@online.de>
Date: Mon, 14 Dec 2009 04:38:51 +0100
Subject: [PATCH] rman.9: Comment out documentation for rman_await_resource().

The code is #if 0'd too.
---
 Makefile_upgrade.inc    |  2 ++
 share/man/man9/Makefile |  2 +-
 share/man/man9/rman.9   | 40 ++++++++++++++++++++--------------------
 3 files changed, 23 insertions(+), 21 deletions(-)

diff --git a/Makefile_upgrade.inc b/Makefile_upgrade.inc
index 680c2a39a5..5766bea94d 100644
--- a/Makefile_upgrade.inc
+++ b/Makefile_upgrade.inc
@@ -1188,3 +1188,5 @@ TO_REMOVE+=/usr/share/man/cat9/serialize_sleep.9.gz
 TO_REMOVE+=/usr/share/man/man9/serialize_sleep.9.gz
 TO_REMOVE+=/usr/share/man/cat9/count_udev.9.gz
 TO_REMOVE+=/usr/share/man/man9/count_udev.9.gz
+TO_REMOVE+=/usr/share/man/cat9/rman_await_resource.9.gz
+TO_REMOVE+=/usr/share/man/man9/rman_await_resource.9.gz
diff --git a/share/man/man9/Makefile b/share/man/man9/Makefile
index cd5dde111f..4020fc2567 100644
--- a/share/man/man9/Makefile
+++ b/share/man/man9/Makefile
@@ -563,7 +563,6 @@ MLINKS+=posix4.9 p1003_1b.9
 MLINKS+=priv.9 priv_check.9 \
 	priv.9 priv_check_cred.9
 MLINKS+=rman.9 rman_activate_resource.9 \
-	rman.9 rman_await_resource.9 \
 	rman.9 rman_deactivate_resource.9 \
 	rman.9 rman_fini.9 \
 	rman.9 rman_get_bushandle.9 \
@@ -582,6 +581,7 @@ MLINKS+=rman.9 rman_activate_resource.9 \
 	rman.9 rman_set_bushandle.9 \
 	rman.9 rman_set_bustag.9 \
 	rman.9 rman_set_virtual.9
+#	rman.9 rman_await_resource.9 \
 #	rman.9 rman_get_rid.9 \
 #	rman.9 rman_reserve_resource_bound.9 \
 #	rman.9 rman_set_rid.9
diff --git a/share/man/man9/rman.9 b/share/man/man9/rman.9
index 4f9e50352a..ef83537c08 100644
--- a/share/man/man9/rman.9
+++ b/share/man/man9/rman.9
@@ -64,7 +64,7 @@
 .Sh NAME
 .Nm rman ,
 .Nm rman_activate_resource ,
-.Nm rman_await_resource ,
+.\".Nm rman_await_resource ,
 .Nm rman_deactivate_resource ,
 .Nm rman_fini ,
 .Nm rman_init ,
@@ -92,8 +92,8 @@
 .In sys/rman.h
 .Ft int
 .Fn rman_activate_resource "struct resource *r"
-.Ft int
-.Fn rman_await_resource "struct resource *r" "int pri2" "int timo"
+.\".Ft int
+.\".Fn rman_await_resource "struct resource *r" "int pri2" "int timo"
 .Ft int
 .Fn rman_deactivate_resource "struct resource *r"
 .Ft int
@@ -271,23 +271,23 @@ as inactive, by clearing the
 flag.
 If other consumers are waiting for this range, it will wakeup their threads.
 .Pp
-The
-.Fn rman_await_resource
-function performs an asynchronous wait for a resource
-.Fa r
-to become inactive, that is, for the
-.Dv RF_ACTIVE
-flag to be cleared.
-It is used to enable cooperative sharing of a resource
-which can only be safely used by one thread at a time.
-The arguments
-.Fa pri
-and
-.Fa timo
-are passed to the
-.Fn rman_await_resource
-function.
-.Pp
+.\"The
+.\".Fn rman_await_resource
+.\"function performs an asynchronous wait for a resource
+.\".Fa r
+.\"to become inactive, that is, for the
+.\".Dv RF_ACTIVE
+.\"flag to be cleared.
+.\"It is used to enable cooperative sharing of a resource
+.\"which can only be safely used by one thread at a time.
+.\"The arguments
+.\".Fa pri
+.\"and
+.\".Fa timo
+.\"are passed to the
+.\".Fn rman_await_resource
+.\"function.
+.\".Pp
 The
 .Fn rman_get_start ,
 .Fn rman_get_end ,
-- 
2.41.0