summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2002-05-30 13:33:59 +0000
committerru <ru@FreeBSD.org>2002-05-30 13:33:59 +0000
commita54f2810df9d723c5e91334cebd479eeb00fa300 (patch)
tree4b59be5168c264ac7620e0de02000bcdface9424
parentfa946e6b488c633331c3d57ab16e6ae28ef88a2b (diff)
downloadFreeBSD-src-a54f2810df9d723c5e91334cebd479eeb00fa300.zip
FreeBSD-src-a54f2810df9d723c5e91334cebd479eeb00fa300.tar.gz
mdoc(7) police: minor markup nits.
-rw-r--r--share/man/man9/mtx_pool.922
-rw-r--r--share/man/man9/selrecord.913
-rw-r--r--usr.bin/asa/asa.134
3 files changed, 42 insertions, 27 deletions
diff --git a/share/man/man9/mtx_pool.9 b/share/man/man9/mtx_pool.9
index 3fa4549..923d9f3 100644
--- a/share/man/man9/mtx_pool.9
+++ b/share/man/man9/mtx_pool.9
@@ -41,9 +41,9 @@
.In sys/param.h
.In sys/lock.h
.In sys/mutex.h
-.Ft struct mtx *
+.Ft "struct mtx *"
.Fn mtx_pool_alloc "void"
-.Ft struct mtx *
+.Ft "struct mtx *"
.Fn mtx_pool_find "void *ptr"
.Ft void
.Fn mtx_pool_lock "void *ptr"
@@ -51,13 +51,13 @@
.Fn mtx_pool_unlock "void *ptr"
.Sh DESCRIPTION
Mutex pools are designed to be used as short term leaf mutexes;
-i.e., the last mutex one might acquire before calling
-.Fn msleep .
+i.e., the last mutex one might acquire before calling
+.Xr msleep 9 .
They operate using a shared pool of mutexes.
A mutex is chosen from the pool based on the supplied pointer,
which may or may not point to anything valid.
.Pp
-The shared mutex managed by the pool module are standard, non-recursive,
+The shared mutexes managed by the pool module are standard, non-recursive,
blockable mutexes, and should only be used in appropriate situations.
.Pp
The caller can lock and unlock mutexes returned by the pool routines, but
@@ -74,6 +74,7 @@ carefully accounted for.
In these cases the private mutex winds up being the true leaf mutex.
.Pp
Pool mutexes have the following advantages:
+.Pp
.Bl -enum -offset indent -compact
.It
No structural overhead;
@@ -85,10 +86,11 @@ mutexes to interlock destructor operations.
No initialization or destruction overhead.
.It
Can be used with
-.Fn msleep .
+.Xr msleep 9 .
.El
.Pp
And the following disadvantages:
+.Pp
.Bl -enum -offset indent -compact
.It
Should generally only be used as leaf mutexes.
@@ -119,9 +121,9 @@ respectively;
they are a combination of
.Fn mtx_pool_find
and
-.Fn mtx_lock
+.Xr mtx_lock 9
and
-.Fn mtx_unlock ,
+.Xr mtx_unlock 9 ,
respectively.
Since these routines must first find the mutex to operate on,
they are not as fast as directly using the pointer (mutex) returned by
@@ -129,8 +131,8 @@ a previous invocation of
.Fn mtx_pool_find .
.Pp
.Sh SEE ALSO
-.Xr mutex 9 ,
-.Xr msleep 9
+.Xr msleep 9 ,
+.Xr mutex 9
.Sh HISTORY
These routines first appeared in
.Fx 5.0 .
diff --git a/share/man/man9/selrecord.9 b/share/man/man9/selrecord.9
index d0b8715..879a30b 100644
--- a/share/man/man9/selrecord.9
+++ b/share/man/man9/selrecord.9
@@ -31,7 +31,7 @@
.Os
.Sh NAME
.Nm selrecord ,
-.Nm selwakeup ,
+.Nm selwakeup
.Nd "record and wakeup select requests"
.Sh SYNOPSIS
.In sys/param.h
@@ -68,7 +68,7 @@ acquires and releases
.Fn selwakeup
is called by the underlying object handling code in order to notify any waiting
threads that an event of interest has occurred.
-If a collision has occurred
+If a collision has occurred,
.Fn selwakeup
will increment
.Va nselcoll ,
@@ -84,7 +84,7 @@ flag which should be noted by
.Xr select 2
and
.Xr poll 2
-when they wakeup.
+when they wake up.
.Pp
.Fn selwakeup
acquires and releases
@@ -92,10 +92,11 @@ acquires and releases
and may acquire and release
.Va sched_lock .
.Sh SEE ALSO
-.Xr poll 2
+.Xr poll 2 ,
.Xr select 2
.Sh AUTHORS
+.An -nosplit
This man page was written by
-.An Chad David Aq davidc@freebsd.org
+.An Chad David Aq davidc@FreeBSD.org
and
-.An Alfred Perlstein Aq alfred@freebsd.org
+.An Alfred Perlstein Aq alfred@FreeBSD.org .
diff --git a/usr.bin/asa/asa.1 b/usr.bin/asa/asa.1
index 259e9b2..c526b5e 100644
--- a/usr.bin/asa/asa.1
+++ b/usr.bin/asa/asa.1
@@ -48,33 +48,44 @@ carriage-control characters to line-printer control sequences,
and writes them to the standard output.
.Pp
The first character of each line is interpreted as a carriage-control
-character. The following characters are interpreted as follows:
-.Bl -tag -width "\*[Lt]space\*[Gt]"
-.It \*[Lt]space\*[Gt]
+character.
+The following characters are interpreted as follows:
+.Bl -tag -width ".Aq space"
+.It Aq space
Output the rest of the line without change.
.It 0
-Output a \*[Lt]newline\*[Gt] character before printing the rest of the line.
+Output a
+.Aq newline
+character before printing the rest of the line.
.It 1
-Output a \*[Lt]formfeed\*[Gt] character before printing the rest of the line.
-.It +
-The trailing \*[Lt]newline\*[Gt] of the previous line is replaced by a \*[Lt]carriage-return\*[Gt]
+Output a
+.Aq formfeed
+character before printing the rest of the line.
+.It \&+
+The trailing
+.Aq newline
+of the previous line is replaced by a
+.Aq carriage-return
before printing the rest of the line.
.El
.Pp
Lines beginning with characters other than the above are treated as if they
-begin with \*[Lt]space\*[Gt].
+begin with
+.Aq space .
.Sh DIAGNOSTICS
.Ex -std
.Sh EXAMPLES
To view a file containing the output of a
.Tn FORTRAN
program:
-.Dl asa file
+.Pp
+.Dl "asa file"
.Pp
To format the output of a
.Tn FORTRAN
program and redirect it to a line-printer:
-.Dl a.out | asa | lpr
+.Pp
+.Dl "a.out | asa | lpr"
.Sh SEE ALSO
.Xr f77 1
.Sh STANDARDS
@@ -83,4 +94,5 @@ The
utility conforms to
.St -p1003.1-2001 .
.Sh AUTHORS
-J.T. Conklin, Winning Strategies, Inc.
+.An J.T. Conklin ,
+Winning Strategies, Inc.
OpenPOWER on IntegriCloud