mdoc(7) police: formatting nits.

Approved by:	re
This commit is contained in:
ru 2002-11-29 15:57:50 +00:00
parent b8e3e0cb20
commit 45774d91ab
19 changed files with 94 additions and 64 deletions

View File

@ -64,7 +64,7 @@
The
.Nm
functions are provided for traversing
.Tn UNIX
.Ux
file hierarchies.
A simple overview is that the
.Fn fts_open

View File

@ -117,7 +117,7 @@ in
The control process will return diagnostic
output from the command (unit 2) on this channel, and will also
accept bytes on this channel as being
.Tn UNIX
.Ux
signal numbers, to be
forwarded to the process group of the command.
If

View File

@ -166,7 +166,7 @@ object may be a complex object
and these routines may be the only way to portably reposition a text stream.
.Pp
If the stream is a wide character stream (see
.Xr fwide 3 Ns No ),
.Xr fwide 3 ) ,
the position specified by the combination of
.Fa offset
and

View File

@ -66,7 +66,8 @@ These functions must not call
if it should be necessary to terminate the process while in such a
function, the
.Xr _exit 2
function should be used. (Alternatively, the function may cause abnormal
function should be used.
(Alternatively, the function may cause abnormal
process termination, for example by calling
.Xr abort 3 . )
.Pp

View File

@ -47,19 +47,34 @@
.Sh SYNOPSIS
.In stdlib.h
.Ft void
.Fn qsort "void *base" "size_t nmemb" "size_t size" "int (*compar)(const void *, const void *)"
.Fo qsort
.Fa "void *base"
.Fa "size_t nmemb"
.Fa "size_t size"
.Fa "int \*[lp]*compar\*[rp]\*[lp]const void *, const void *\*[rp]"
.Fc
.Ft void
.Fo qsort_r
.Fa "void *base"
.Fa "size_t nmemb"
.Fa "size_t size"
.Fa "void *thunk"
.Fa "int (*compar)(void *, const void *, const void *)"
.Fa "int \*[lp]*compar\*[rp]\*[lp]void *, const void *, const void *\*[rp]"
.Fc
.Ft int
.Fn heapsort "void *base" "size_t nmemb" "size_t size" "int (*compar)(const void *, const void *)"
.Fo heapsort
.Fa "void *base"
.Fa "size_t nmemb"
.Fa "size_t size"
.Fa "int \*[lp]*compar\*[rp]\*[lp]const void *, const void *\*[rp]"
.Fc
.Ft int
.Fn mergesort "void *base" "size_t nmemb" "size_t size" "int (*compar)(const void *, const void *)"
.Fo mergesort
.Fa "void *base"
.Fa "size_t nmemb"
.Fa "size_t size"
.Fa "int \*[lp]*compar\*[rp]\*[lp]const void *, const void *\*[rp]"
.Fc
.Sh DESCRIPTION
The
.Fn qsort
@ -132,7 +147,9 @@ The
.Fn qsort
and
.Fn qsort_r
functions are an implementation of C.A.R. Hoare's ``quicksort'' algorithm,
functions are an implementation of C.A.R. Hoare's
.Dq quicksort
algorithm,
a variant of partition-exchange sorting; in particular, see D.E. Knuth's
Algorithm Q.
.Sy Quicksort
@ -142,7 +159,9 @@ O N**2 worst-case behavior.
.Pp
The
.Fn heapsort
function is an implementation of J.W.J. William's ``heapsort'' algorithm,
function is an implementation of J.W.J. William's
.Dq heapsort
algorithm,
a variant of selection sorting; in particular, see D.E. Knuth's Algorithm H.
.Sy Heapsort
takes O N lg N worst-case time.

View File

@ -49,7 +49,7 @@ bytes are placed into the array.
.Pp
The format string is composed of zero or more directives:
ordinary characters (not
.Cm % Ns ),
.Cm % ) ,
which are copied unchanged to the output stream; and conversion
specifications, each of which results in fetching zero or more subsequent
arguments.
@ -75,9 +75,9 @@ Do not use grouping characters, regardless of the current locale default.
Represent positive values by prefixing them with a positive sign,
and negative values by prefixing them with a negative sign.
This is the default.
.It Cm (
.It Cm \&(
Enclose negative values in parentheses.
.It Cm !
.It Cm \&!
Do not include a currency symbol in the output.
.It Cm \-
Left justify the result.
@ -124,7 +124,7 @@ returns the number of bytes placed into the array pointed to by
not including the terminating
.Dv NULL
byte.
Otherwise, -1 is returned,
Otherwise, \-1 is returned,
the contents of the array are indeterminate,
and
.Va errno

View File

@ -65,7 +65,9 @@ The original value of
.Fa *stringp
is returned.
.Pp
An ``empty'' field (i.e., a character in the string
An
.Dq empty
field (i.e., a character in the string
.Fa delim
occurs as the first character of
.Fa *stringp )

View File

@ -456,7 +456,6 @@ The specified extended attribute does not exist.
.It Er 88 EDOOFUS Em "Programming error" .
A function or API is being abused in a way which could only be detected
at run-time.
.El
.Sh DEFINITIONS
.Bl -tag -width Ds

View File

@ -106,7 +106,7 @@ otherwise 0.
Returns 1 if synchronised I/O is supported for this file, otherwise 0.
.It Li _PC_ALLOC_SIZE_MIN
Minimum number of bytes of storage allocated for any portion of a file.
.Ar path .
.Fa path .
.It Li _PC_FILESIZEBITS
Number of bits needed to represented the maximum file size.
.It Li _PC_REC_INCR_XFER_SIZE

View File

@ -56,8 +56,11 @@ struct sigaction {
#define sa_sigaction __sigaction_u.__sa_sigaction
.Ed
.Ft int
.Fn sigaction "int sig" "const struct sigaction * restrict act" \
"struct sigaction * restrict oact"
.Fo sigaction
.Fa "int sig"
.Fa "const struct sigaction * restrict act"
.Fa "struct sigaction * restrict oact"
.Fc
.Sh DESCRIPTION
The system defines a set of signals that may be delivered to a process.
Signal delivery resembles the occurrence of a hardware interrupt:

View File

@ -43,8 +43,11 @@
.Sh SYNOPSIS
.In signal.h
.Ft int
.Fn sigprocmask "int how" "const sigset_t * restrict set" \
"sigset_t * restrict oset"
.Fo sigprocmask
.Fa "int how"
.Fa "const sigset_t * restrict set"
.Fa "sigset_t * restrict oset"
.Fc
.Sh DESCRIPTION
The
.Fn sigprocmask

View File

@ -86,7 +86,7 @@ process address space.
.Xr write 2
.Sh BUGS
This call is currently implemented only for the
.Tn UNIX
.Ux
domain.
.Sh HISTORY
The

View File

@ -75,22 +75,21 @@ struct uuid {
uint8_t node[_UUID_NODE_LEN];
};
.Ed
.Pp
.Bl -tag -width _clock_seq_hi_and_reserved_
.It time_low
.Bl -tag -width ".Va clock_seq_hi_and_reserved"
.It Va time_low
The least significant 32 bits of a 60-bit timestamp.
This field is stored in the native byte-order.
.It time_mid
.It Va time_mid
The least significant 16 bits of the most significant 28 bits of the 60-bit
timestamp.
This field is stored in the native byte-order.
.It time_hi_and_reserved
.It Va time_hi_and_reserved
The most significant 12 bits of the 60-bit timestamp multiplexed with a 4-bit
version number.
The version number is stored in the most significant 4 bits of the 16-bit
field.
This field is stored in the native byte-order.
.It clock_seq_hi_and_reserved
.It Va clock_seq_hi_and_reserved
The most significant 6 bits of a 14-bit sequence number multiplexed with a
2-bit variant value.
Note that the width of the variant value is determined by the variant itself.
@ -98,9 +97,9 @@ Identifiers generated by the
.Nm
system call have variant value 10b.
the variant value is stored in the most significant bits of the field.
.It clock_seq_low
.It Va clock_seq_low
The least significant 8 bits of a 14-bit sequence number.
.It node
.It Va node
The 6-byte IEEE 802 (MAC) address of one of the interfaces of the node.
If no such interface exists, a random multi-cast address is used instead.
.El

View File

@ -99,7 +99,7 @@ in
The control process will return diagnostic
output from the command (unit 2) on this channel, and will also
accept bytes on this channel as being
.Tn UNIX
.Ux
signal numbers, to be
forwarded to the process group of the command. The diagnostic
information returned does not include remote authorization failure,

View File

@ -77,7 +77,7 @@ prompts for one as usual.
causes echoing to be left on if
.Nm
prompts for a password.
.It Cm conf Ns No = Ns Ar pathname
.It Cm conf Ns = Ns Ar pathname
specifies a non-standard location for the RADIUS client configuration file
(normally located in
.Pa /etc/radius.conf ) .

View File

@ -108,9 +108,12 @@ return
.Dv PAM_IGNORE
if the specified group (default group of
.Dq Li wheel )
is empty, providing traditional BSD
is empty, providing traditional
.Bx
.Xr su 8
semantics permitting any user to su if the wheel group is empty.
semantics permitting any user to
.Dq su
if the wheel group is empty.
.El
.Sh SEE ALSO
.Xr getlogin 2 ,

View File

@ -114,7 +114,7 @@ in which case the standard configuration file
.Pa /etc/tacplus.conf
is used.
.Fn tac_config
returns 0 on success, or -1 if an error occurs.
returns 0 on success, or \-1 if an error occurs.
.Pp
The library can also be configured programmatically by calls to
.Fn tac_add_server .
@ -148,7 +148,7 @@ confused if the client attempts to negotiate it.
.El
.Pp
.Fn tac_add_server
returns 0 on success, or -1 if an error occurs.
returns 0 on success, or \-1 if an error occurs.
.Pp
.Fn tac_add_server
may be called multiple times, and it may be used together with
@ -168,7 +168,7 @@ and
.Va service
arguments must be set to appropriate values as defined in the
TACACS+ protocol specification. The
.Aq taclib.h
.Aq Pa taclib.h
header file contains symbolic constants for these values.
.Sh CREATING A TACACS+ AUTHORIZATION REQUEST
To begin constructing a new authorization request, call
@ -180,7 +180,7 @@ and
.Va service
arguments must be set to appropriate values as defined in the
TACACS+ protocol specification. The
.Aq taclib.h
.Aq Pa taclib.h
header file contains symbolic constants for these values.
.Sh SETTING OPTIONAL PARAMETERS ON A REQUEST
After creating a request,
@ -217,12 +217,12 @@ sent by means of
This function connects to a server if not already connected, sends
the request, and waits for a reply. On failure,
.Fn tac_send_authen
returns -1. Otherwise, it returns the TACACS+ status code and flags,
returns \-1. Otherwise, it returns the TACACS+ status code and flags,
packed into an integer value. The status can be extracted using the
macro
.Fn TAC_AUTHEN_STATUS .
Possible status codes, defined in
.Aq taclib.h ,
.Aq Pa taclib.h ,
include:
.Pp
.Bl -item -compact -offset indent
@ -307,12 +307,12 @@ is sent by means of
This function connects to a server if not already connected, sends
the request, and waits for a reply. On failure,
.Fn tac_send_author
returns -1. Otherwise, it returns the TACACS+ status code and
returns \-1. Otherwise, it returns the TACACS+ status code and
number of attribute value (AV) pairs received packed into an
integer value. The status can be extracted using the macro
.Fn TAC_AUTHOR_STATUS .
Possible status codes, defined in
.Aq taclib.h ,
.Aq Pa taclib.h ,
include:
.Pp
.Bl -item -compact -offset indent
@ -372,7 +372,7 @@ To free the resources used by the TACACS+ library, call
.Fn tac_close .
.Sh RETURN VALUES
The following functions return a non-negative value on success. If
they detect an error, they return -1 and record an error message
they detect an error, they return \-1 and record an error message
which can be retrieved using
.Fn tac_strerror .
.Pp
@ -446,8 +446,9 @@ without recording an error message.
.%O draft-grant-tacacs-02.txt (Internet Draft)
.Re
.Sh AUTHORS
.An -nosplit
This software was written by
.An John Polstra ,
.An John Polstra
and
.An Paul Fraley ,
and donated to the