From 05cb5024af59af7a081804ab367a2675ddef71ea Mon Sep 17 00:00:00 2001 From: Ruslan Ermilov Date: Thu, 30 May 2002 13:33:59 +0000 Subject: [PATCH] mdoc(7) police: minor markup nits. --- share/man/man9/mtx_pool.9 | 22 ++++++++++++---------- share/man/man9/selrecord.9 | 13 +++++++------ usr.bin/asa/asa.1 | 34 +++++++++++++++++++++++----------- 3 files changed, 42 insertions(+), 27 deletions(-) diff --git a/share/man/man9/mtx_pool.9 b/share/man/man9/mtx_pool.9 index 3fa454961c5f..923d9f369fb7 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 d0b87153cbfc..879a30b0e4ce 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 259e9b26d441..c526b5e3d9b5 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.