diff options
author | ru <ru@FreeBSD.org> | 2002-11-29 15:57:50 +0000 |
---|---|---|
committer | ru <ru@FreeBSD.org> | 2002-11-29 15:57:50 +0000 |
commit | 3f859aa2ab91ed5a7f52ef2667cdd5d040bcbdf7 (patch) | |
tree | 15ecd517a64da40d5f62adfdcbb03cc605dfac67 /lib/libc/stdlib | |
parent | 8bfe544f0ac6dbbaab251f97964f8e610ea7579f (diff) | |
download | FreeBSD-src-3f859aa2ab91ed5a7f52ef2667cdd5d040bcbdf7.zip FreeBSD-src-3f859aa2ab91ed5a7f52ef2667cdd5d040bcbdf7.tar.gz |
mdoc(7) police: formatting nits.
Approved by: re
Diffstat (limited to 'lib/libc/stdlib')
-rw-r--r-- | lib/libc/stdlib/atexit.3 | 3 | ||||
-rw-r--r-- | lib/libc/stdlib/qsort.3 | 33 | ||||
-rw-r--r-- | lib/libc/stdlib/strfmon.3 | 8 |
3 files changed, 32 insertions, 12 deletions
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 |