mdoc(7) police: minor markup nits.

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.