mdoc(7) police: minor markup nits.
This commit is contained in:
parent
3a47359931
commit
05cb5024af
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=97597
@ -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 .
|
||||
|
@ -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 .
|
||||
|
@ -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.
|
||||
|
Loading…
Reference in New Issue
Block a user