summaryrefslogtreecommitdiffstats
path: root/lib/libc
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2002-11-29 15:57:50 +0000
committerru <ru@FreeBSD.org>2002-11-29 15:57:50 +0000
commit3f859aa2ab91ed5a7f52ef2667cdd5d040bcbdf7 (patch)
tree15ecd517a64da40d5f62adfdcbb03cc605dfac67 /lib/libc
parent8bfe544f0ac6dbbaab251f97964f8e610ea7579f (diff)
downloadFreeBSD-src-3f859aa2ab91ed5a7f52ef2667cdd5d040bcbdf7.zip
FreeBSD-src-3f859aa2ab91ed5a7f52ef2667cdd5d040bcbdf7.tar.gz
mdoc(7) police: formatting nits.
Approved by: re
Diffstat (limited to 'lib/libc')
-rw-r--r--lib/libc/gen/fts.32
-rw-r--r--lib/libc/net/rcmd.32
-rw-r--r--lib/libc/stdio/fseek.32
-rw-r--r--lib/libc/stdlib/atexit.33
-rw-r--r--lib/libc/stdlib/qsort.333
-rw-r--r--lib/libc/stdlib/strfmon.38
-rw-r--r--lib/libc/string/strcpy.32
-rw-r--r--lib/libc/string/strsep.34
-rw-r--r--lib/libc/sys/intro.21
-rw-r--r--lib/libc/sys/kse.22
-rw-r--r--lib/libc/sys/pathconf.22
-rw-r--r--lib/libc/sys/sigaction.27
-rw-r--r--lib/libc/sys/sigprocmask.27
-rw-r--r--lib/libc/sys/socketpair.22
-rw-r--r--lib/libc/sys/uuidgen.215
15 files changed, 59 insertions, 33 deletions
diff --git a/lib/libc/gen/fts.3 b/lib/libc/gen/fts.3
index 4526266..b50b316 100644
--- a/lib/libc/gen/fts.3
+++ b/lib/libc/gen/fts.3
@@ -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
diff --git a/lib/libc/net/rcmd.3 b/lib/libc/net/rcmd.3
index 1193065..ba2cc55 100644
--- a/lib/libc/net/rcmd.3
+++ b/lib/libc/net/rcmd.3
@@ -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
diff --git a/lib/libc/stdio/fseek.3 b/lib/libc/stdio/fseek.3
index f2ca10f..6481fe6 100644
--- a/lib/libc/stdio/fseek.3
+++ b/lib/libc/stdio/fseek.3
@@ -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
diff --git a/lib/libc/stdlib/atexit.3 b/lib/libc/stdlib/atexit.3
index cc434cc..9aae7af 100644
--- a/lib/libc/stdlib/atexit.3
+++ b/lib/libc/stdlib/atexit.3
@@ -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
diff --git a/lib/libc/stdlib/qsort.3 b/lib/libc/stdlib/qsort.3
index 39d6e0c..a23301f 100644
--- a/lib/libc/stdlib/qsort.3
+++ b/lib/libc/stdlib/qsort.3
@@ -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
@@ -111,7 +126,7 @@ except that it takes an additional argument,
which is passed unchanged as the first argument to function pointed to
.Fa compar .
This allows the comparison function to access additional
-data without using global variables, and thus
+data without using global variables, and thus
.Fn qsort_r
is suitable for use in functions which must be reentrant.
.Pp
@@ -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.
diff --git a/lib/libc/stdlib/strfmon.3 b/lib/libc/stdlib/strfmon.3
index 4c553de..7e5a9c0 100644
--- a/lib/libc/stdlib/strfmon.3
+++ b/lib/libc/stdlib/strfmon.3
@@ -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
diff --git a/lib/libc/string/strcpy.3 b/lib/libc/string/strcpy.3
index 01456d0..d52d0ed 100644
--- a/lib/libc/string/strcpy.3
+++ b/lib/libc/string/strcpy.3
@@ -99,7 +99,7 @@ return
.Fa dst .
The
.Fn stpcpy
-function returns a pointer to the terminating
+function returns a pointer to the terminating
.Ql \e0
character of
.Fa dst .
diff --git a/lib/libc/string/strsep.3 b/lib/libc/string/strsep.3
index 12bd585..77c7b84 100644
--- a/lib/libc/string/strsep.3
+++ b/lib/libc/string/strsep.3
@@ -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 )
diff --git a/lib/libc/sys/intro.2 b/lib/libc/sys/intro.2
index c4804c1..2791452 100644
--- a/lib/libc/sys/intro.2
+++ b/lib/libc/sys/intro.2
@@ -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
diff --git a/lib/libc/sys/kse.2 b/lib/libc/sys/kse.2
index 9146ca4..0497bc2 100644
--- a/lib/libc/sys/kse.2
+++ b/lib/libc/sys/kse.2
@@ -469,7 +469,7 @@ and
.Va tm_sticks
are time counters for user mode and kernel mode execution, respectively.
These counters count ticks of the statistics clock (see
-.Xr clocks 7) .
+.Xr clocks 7 ) .
While any thread is actively executing in the kernel, the corresponding
.Va tm_sticks
counter is incremented.
diff --git a/lib/libc/sys/pathconf.2 b/lib/libc/sys/pathconf.2
index 87ec6e4..fbf54cc 100644
--- a/lib/libc/sys/pathconf.2
+++ b/lib/libc/sys/pathconf.2
@@ -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
diff --git a/lib/libc/sys/sigaction.2 b/lib/libc/sys/sigaction.2
index cedc7a0..898de2b 100644
--- a/lib/libc/sys/sigaction.2
+++ b/lib/libc/sys/sigaction.2
@@ -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:
diff --git a/lib/libc/sys/sigprocmask.2 b/lib/libc/sys/sigprocmask.2
index 7f271be..debb2a3 100644
--- a/lib/libc/sys/sigprocmask.2
+++ b/lib/libc/sys/sigprocmask.2
@@ -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
diff --git a/lib/libc/sys/socketpair.2 b/lib/libc/sys/socketpair.2
index a1e6fb8..929b921 100644
--- a/lib/libc/sys/socketpair.2
+++ b/lib/libc/sys/socketpair.2
@@ -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
diff --git a/lib/libc/sys/uuidgen.2 b/lib/libc/sys/uuidgen.2
index 726039a..d2881cc 100644
--- a/lib/libc/sys/uuidgen.2
+++ b/lib/libc/sys/uuidgen.2
@@ -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
OpenPOWER on IntegriCloud