From a280550abf7f97914cd92e86e0e698b51c48a46c Mon Sep 17 00:00:00 2001
From: Julian Elischer <julian@FreeBSD.org>
Date: Fri, 30 Mar 2007 18:07:26 +0000
Subject: [PATCH] Add some cross references to locking.9 from related pages.

---
 share/man/man9/condvar.9  | 1 +
 share/man/man9/lock.9     | 6 ++++++
 share/man/man9/mtx_pool.9 | 1 +
 share/man/man9/mutex.9    | 1 +
 share/man/man9/rwlock.9   | 1 +
 share/man/man9/sema.9     | 1 +
 share/man/man9/sleep.9    | 1 +
 share/man/man9/sx.9       | 2 ++
 8 files changed, 14 insertions(+)

diff --git a/share/man/man9/condvar.9 b/share/man/man9/condvar.9
index f54c73fa0d86..b54341a6e345 100644
--- a/share/man/man9/condvar.9
+++ b/share/man/man9/condvar.9
@@ -200,6 +200,7 @@ will fail if:
 Timeout expired.
 .El
 .Sh SEE ALSO
+.Xr locking 9 ,
 .Xr mtx_pool 9 ,
 .Xr mutex 9 ,
 .Xr rwlock 9 ,
diff --git a/share/man/man9/lock.9 b/share/man/man9/lock.9
index 94e03dd0cf51..5a9a455dda90 100644
--- a/share/man/man9/lock.9
+++ b/share/man/man9/lock.9
@@ -272,7 +272,13 @@ exclusive lock, and a
 .Xr panic 9
 will be the result of trying.
 .Sh SEE ALSO
+.Xr condvar 9 ,
+.Xr mutex 9 ,
+.Xr locking 9 ,
+.Xr mutex 9 ,
+.Xr rwlock 9 ,
 .Xr sleep 9 ,
+.Xr sx 9 ,
 .Xr mtx_assert 9 ,
 .Xr panic 9 ,
 .Xr VOP_PRINT 9
diff --git a/share/man/man9/mtx_pool.9 b/share/man/man9/mtx_pool.9
index 0d6af1c810ed..e289f3c18363 100644
--- a/share/man/man9/mtx_pool.9
+++ b/share/man/man9/mtx_pool.9
@@ -177,6 +177,7 @@ on each mutex in the specified pool,
 deallocates the memory associated with the pool,
 and assigns NULL to the pool pointer.
 .Sh SEE ALSO
+.Xr locking 9
 .Xr mutex 9
 .Sh HISTORY
 These routines first appeared in
diff --git a/share/man/man9/mutex.9 b/share/man/man9/mutex.9
index c73dfee74875..b27f7f9463c4 100644
--- a/share/man/man9/mutex.9
+++ b/share/man/man9/mutex.9
@@ -510,6 +510,7 @@ No locks are needed when calling these functions.
 .Sh SEE ALSO
 .Xr condvar 9 ,
 .Xr LOCK_PROFILING 9 ,
+.Xr locking 9 ,
 .Xr mtx_pool 9 ,
 .Xr panic 9 ,
 .Xr rwlock 9 ,
diff --git a/share/man/man9/rwlock.9 b/share/man/man9/rwlock.9
index 7f1a4314058f..a06c056c9d3f 100644
--- a/share/man/man9/rwlock.9
+++ b/share/man/man9/rwlock.9
@@ -215,6 +215,7 @@ Assert that current thread holds neither a shared nor exclusive lock of
 .El
 .El
 .Sh SEE ALSO
+.Xr locking 9 ,
 .Xr mutex 9 ,
 .Xr panic 9 ,
 .Xr sema 9 ,
diff --git a/share/man/man9/sema.9 b/share/man/man9/sema.9
index 5ac5b24ace12..1f6e3b54eb24 100644
--- a/share/man/man9/sema.9
+++ b/share/man/man9/sema.9
@@ -125,6 +125,7 @@ Timeout expired.
 .El
 .Sh SEE ALSO
 .Xr condvar 9 ,
+.Xr locking 9 ,
 .Xr mtx_pool 9 ,
 .Xr mutex 9 ,
 .Xr rwlock 9 ,
diff --git a/share/man/man9/sleep.9 b/share/man/man9/sleep.9
index 89ec6a76ed3e..002924247301 100644
--- a/share/man/man9/sleep.9
+++ b/share/man/man9/sleep.9
@@ -264,6 +264,7 @@ A non-zero timeout was specified and the timeout expired.
 .El
 .Sh SEE ALSO
 .Xr ps 1 ,
+.Xr locking 9 ,
 .Xr malloc 9 ,
 .Xr mi_switch 9 ,
 .Xr mtx_sleep 9 ,
diff --git a/share/man/man9/sx.9 b/share/man/man9/sx.9
index 50c0bc4f2773..447e48c58a8f 100644
--- a/share/man/man9/sx.9
+++ b/share/man/man9/sx.9
@@ -222,6 +222,8 @@ lock while another thread blocked on the same
 lock after acquiring a mutex, then the second thread would effectively
 end up sleeping while holding a mutex, which is not allowed.
 .Sh SEE ALSO
+.Xr locking 9 ,
+.Xr lock 9 ,
 .Xr mutex 9 ,
 .Xr panic 9 ,
 .Xr rwlock 9 ,