From 928d297eeb1b1084c1525eb3aba0cee109fed2b6 Mon Sep 17 00:00:00 2001 From: ru Date: Thu, 17 Nov 2005 13:00:00 +0000 Subject: -mdoc sweep. --- lib/libarchive/libarchive-formats.5 | 2 +- lib/libc/locale/isalnum.3 | 2 +- lib/libc/locale/isalpha.3 | 2 +- lib/libc/locale/isblank.3 | 2 +- lib/libc/locale/iscntrl.3 | 2 +- lib/libc/locale/isdigit.3 | 2 +- lib/libc/locale/isgraph.3 | 2 +- lib/libc/locale/islower.3 | 2 +- lib/libc/locale/isprint.3 | 2 +- lib/libc/locale/ispunct.3 | 2 +- lib/libc/locale/isspace.3 | 2 +- lib/libc/locale/isupper.3 | 2 +- lib/libc/locale/isxdigit.3 | 2 +- lib/libc/locale/tolower.3 | 2 +- lib/libc/locale/toupper.3 | 2 +- lib/libc/posix1e/acl_get_entry.3 | 2 +- lib/libc/sys/mmap.2 | 7 +++++-- lib/libc/sys/read.2 | 2 +- lib/libc/sys/recv.2 | 2 +- lib/libc/sys/sendfile.2 | 2 +- lib/libc/sys/sigwait.2 | 20 +++++++++++++------- lib/libc/sys/wait.2 | 22 +++++++++++++++------- lib/libc/sys/write.2 | 2 +- lib/libedit/editline.3 | 17 ++++++++++------- lib/libedit/editrc.5 | 2 +- lib/libmd/sha256.3 | 2 +- lib/libpmc/pmc.3 | 20 ++++++++++---------- lib/libpmc/pmclog.3 | 2 +- lib/msun/man/ieee_test.3 | 2 +- lib/msun/man/ilogb.3 | 2 +- lib/msun/man/math.3 | 2 +- 31 files changed, 79 insertions(+), 59 deletions(-) diff --git a/lib/libarchive/libarchive-formats.5 b/lib/libarchive/libarchive-formats.5 index ac2cccd..7ed18da 100644 --- a/lib/libarchive/libarchive-formats.5 +++ b/lib/libarchive/libarchive-formats.5 @@ -108,7 +108,7 @@ can read POSIX-compliant pax interchange format archives. Programs that correctly read ustar format (see below) will also be able to read this format; any extended attributes will be extracted as separate files stored in -.Pn PaxHeader +.Pa PaxHeader directories. .It Cm ustar The libarchive library can both read and write this format. diff --git a/lib/libc/locale/isalnum.3 b/lib/libc/locale/isalnum.3 index 02e2dd2..d550485 100644 --- a/lib/libc/locale/isalnum.3 +++ b/lib/libc/locale/isalnum.3 @@ -57,7 +57,7 @@ or .Xr isdigit 3 is true. The value of the argument must be representable as an -.Vt unsigned char +.Vt "unsigned char" or the value of .Dv EOF . .Pp diff --git a/lib/libc/locale/isalpha.3 b/lib/libc/locale/isalpha.3 index 0959149..1996059 100644 --- a/lib/libc/locale/isalpha.3 +++ b/lib/libc/locale/isalpha.3 @@ -57,7 +57,7 @@ or .Xr islower 3 is true. The value of the argument must be representable as an -.Vt unsigned char +.Vt "unsigned char" or the value of .Dv EOF . .Pp diff --git a/lib/libc/locale/isblank.3 b/lib/libc/locale/isblank.3 index a027cd6..2af673a 100644 --- a/lib/libc/locale/isblank.3 +++ b/lib/libc/locale/isblank.3 @@ -58,7 +58,7 @@ In the "C" locale .Fn isblank successful test is limited to this characters only. The value of the argument must be representable as an -.Vt unsigned char +.Vt "unsigned char" or the value of .Dv EOF . .Sh RETURN VALUES diff --git a/lib/libc/locale/iscntrl.3 b/lib/libc/locale/iscntrl.3 index 25e8954..e8b537b 100644 --- a/lib/libc/locale/iscntrl.3 +++ b/lib/libc/locale/iscntrl.3 @@ -53,7 +53,7 @@ The .Fn iscntrl function tests for any control character. The value of the argument must be representable as an -.Vt unsigned char +.Vt "unsigned char" or the value of .Dv EOF . .Pp diff --git a/lib/libc/locale/isdigit.3 b/lib/libc/locale/isdigit.3 index 2505743..8bcf083 100644 --- a/lib/libc/locale/isdigit.3 +++ b/lib/libc/locale/isdigit.3 @@ -69,7 +69,7 @@ but may recognize additional characters, depending on the current locale setting. .Pp The value of the argument must be representable as an -.Vt unsigned char +.Vt "unsigned char" or the value of .Dv EOF . .Sh RETURN VALUES diff --git a/lib/libc/locale/isgraph.3 b/lib/libc/locale/isgraph.3 index 632610b..f5cc2eb 100644 --- a/lib/libc/locale/isgraph.3 +++ b/lib/libc/locale/isgraph.3 @@ -56,7 +56,7 @@ function tests for any printing character except space and other locale specific space-like characters. The value of the argument must be representable as an -.Vt unsigned char +.Vt "unsigned char" or the value of .Dv EOF . .Pp diff --git a/lib/libc/locale/islower.3 b/lib/libc/locale/islower.3 index bf9bcef..5d7c378 100644 --- a/lib/libc/locale/islower.3 +++ b/lib/libc/locale/islower.3 @@ -53,7 +53,7 @@ The .Fn islower function tests for any lower-case letters. The value of the argument must be representable as an -.Vt unsigned char +.Vt "unsigned char" or the value of .Dv EOF . .Pp diff --git a/lib/libc/locale/isprint.3 b/lib/libc/locale/isprint.3 index a01f863..5217f13 100644 --- a/lib/libc/locale/isprint.3 +++ b/lib/libc/locale/isprint.3 @@ -54,7 +54,7 @@ The function tests for any printing character including space .Pq Ql "\ " . The value of the argument must be representable as an -.Vt unsigned char +.Vt "unsigned char" or the value of .Dv EOF . .Pp diff --git a/lib/libc/locale/ispunct.3 b/lib/libc/locale/ispunct.3 index 2ae06ed..80acf15 100644 --- a/lib/libc/locale/ispunct.3 +++ b/lib/libc/locale/ispunct.3 @@ -58,7 +58,7 @@ character for which .Xr isalnum 3 is true. The value of the argument must be representable as an -.Vt unsigned char +.Vt "unsigned char" or the value of .Dv EOF . .Pp diff --git a/lib/libc/locale/isspace.3 b/lib/libc/locale/isspace.3 index 13f06bf..5a77015 100644 --- a/lib/libc/locale/isspace.3 +++ b/lib/libc/locale/isspace.3 @@ -62,7 +62,7 @@ In the "C" locale .Fn isspace successful test is limited to this characters only. The value of the argument must be representable as an -.Vt unsigned char +.Vt "unsigned char" or the value of .Dv EOF . .Sh RETURN VALUES diff --git a/lib/libc/locale/isupper.3 b/lib/libc/locale/isupper.3 index f8e403f..b92fe7c 100644 --- a/lib/libc/locale/isupper.3 +++ b/lib/libc/locale/isupper.3 @@ -53,7 +53,7 @@ The .Fn isupper function tests for any upper-case letter. The value of the argument must be representable as an -.Vt unsigned char +.Vt "unsigned char" or the value of .Dv EOF . .Pp diff --git a/lib/libc/locale/isxdigit.3 b/lib/libc/locale/isxdigit.3 index 16c64b1..8e3d9b9 100644 --- a/lib/libc/locale/isxdigit.3 +++ b/lib/libc/locale/isxdigit.3 @@ -72,7 +72,7 @@ but may recognize additional characters, depending on the current locale setting. .Pp The value of the argument must be representable as an -.Vt unsigned char +.Vt "unsigned char" or the value of .Dv EOF . .Sh RETURN VALUES diff --git a/lib/libc/locale/tolower.3 b/lib/libc/locale/tolower.3 index 08d25cc..4934284 100644 --- a/lib/libc/locale/tolower.3 +++ b/lib/libc/locale/tolower.3 @@ -54,7 +54,7 @@ The function converts an upper-case letter to the corresponding lower-case letter. The argument must be representable as an -.Vt unsigned char +.Vt "unsigned char" or the value of .Dv EOF . .Sh RETURN VALUES diff --git a/lib/libc/locale/toupper.3 b/lib/libc/locale/toupper.3 index 381f080..b3ce8ff 100644 --- a/lib/libc/locale/toupper.3 +++ b/lib/libc/locale/toupper.3 @@ -54,7 +54,7 @@ The function converts a lower-case letter to the corresponding upper-case letter. The argument must be representable as an -.Vt unsigned char +.Vt "unsigned char" or the value of .Dv EOF . .Sh RETURN VALUES diff --git a/lib/libc/posix1e/acl_get_entry.3 b/lib/libc/posix1e/acl_get_entry.3 index 8b9f135..42e03c1 100644 --- a/lib/libc/posix1e/acl_get_entry.3 +++ b/lib/libc/posix1e/acl_get_entry.3 @@ -79,7 +79,7 @@ then the result is unspecified. .Sh RETURN VALUES If the .Fn acl_get_entry -function successfuly obtains an ACL entry, a value of 1 is returned. +function successfully obtains an ACL entry, a value of 1 is returned. If the ACL has no ACL entries, the .Fn acl_get_entry returns a value of 0. diff --git a/lib/libc/sys/mmap.2 b/lib/libc/sys/mmap.2 index 522c559..f4c0b42 100644 --- a/lib/libc/sys/mmap.2 +++ b/lib/libc/sys/mmap.2 @@ -123,12 +123,15 @@ If is specified, .Fa addr must be a multiple of the pagesize. -If a MAP_FIXED request is successful, the mapping established by +If a +.Dv MAP_FIXED +request is successful, the mapping established by .Fn mmap replaces any previous mappings for the process' pages in the range from .Fa addr to -.Fa addr + +.Fa addr ++ .Fa len . Use of this option is discouraged. .It Dv MAP_HASSEMAPHORE diff --git a/lib/libc/sys/read.2 b/lib/libc/sys/read.2 index 6304f01..2dccb0e 100644 --- a/lib/libc/sys/read.2 +++ b/lib/libc/sys/read.2 @@ -32,7 +32,7 @@ .\" @(#)read.2 8.4 (Berkeley) 2/26/94 .\" $FreeBSD$ .\" -.Dd October 16, 2004 +.Dd July 29, 2005 .Dt READ 2 .Os .Sh NAME diff --git a/lib/libc/sys/recv.2 b/lib/libc/sys/recv.2 index f0eb35c..3d89f4f 100644 --- a/lib/libc/sys/recv.2 +++ b/lib/libc/sys/recv.2 @@ -32,7 +32,7 @@ .\" @(#)recv.2 8.3 (Berkeley) 2/21/94 .\" $FreeBSD$ .\" -.Dd February 21, 1994 +.Dd July 29, 2005 .Dt RECV 2 .Os .Sh NAME diff --git a/lib/libc/sys/sendfile.2 b/lib/libc/sys/sendfile.2 index 2b2da3d..57feb14 100644 --- a/lib/libc/sys/sendfile.2 +++ b/lib/libc/sys/sendfile.2 @@ -25,7 +25,7 @@ .\" .\" $FreeBSD$ .\" -.Dd October 16, 2004 +.Dd October 31, 2005 .Dt SENDFILE 2 .Os .Sh NAME diff --git a/lib/libc/sys/sigwait.2 b/lib/libc/sys/sigwait.2 index 632d991..8c00cf4 100644 --- a/lib/libc/sys/sigwait.2 +++ b/lib/libc/sys/sigwait.2 @@ -27,7 +27,7 @@ .\" .\" $FreeBSD$ .\" -.Dd April 27, 2000 +.Dd November 11, 2005 .Dt SIGWAIT 2 .Os .Sh NAME @@ -63,7 +63,8 @@ If more than one thread is using .Fn sigwait to wait for the same signal, no more than one of these threads will return from .Fn sigwait -with the signal number. If more than a single thread is blocked in +with the signal number. +If more than a single thread is blocked in .Fn sigwait for a signal when that signal is generated for the process, it is unspecified which of the waiting threads returns from @@ -72,8 +73,13 @@ If the signal is generated for a specific thread, as by .Fn pthread_kill , only that thread will return. .Pp -Should any of the multiple pending signals in the range SIGRTMIN to SIGRTMAX be -selected, it will be the lowest numbered one. The selection order between realtime +Should any of the multiple pending signals in the range +.Dv SIGRTMIN +to +.Dv SIGRTMAX +be +selected, it will be the lowest numbered one. +The selection order between realtime and non-realtime signals, or between multiple pending non-realtime signals, is unspecified. .Sh RETURN VALUES @@ -98,12 +104,12 @@ Any arguments point outside the allocated address space or there is a memory protection fault. .El .Sh SEE ALSO -.Xr sigtimedwait 2 , -.Xr sigwaitinfo 2 , -.Xr sigqueue 2 , .Xr sigaction 2 , .Xr sigpending 2 , +.Xr sigqueue 2 , .Xr sigsuspend 2 , +.Xr sigtimedwait 2 , +.Xr sigwaitinfo 2 , .Xr pause 3 , .Xr pthread_sigmask 3 .Sh STANDARDS diff --git a/lib/libc/sys/wait.2 b/lib/libc/sys/wait.2 index 304824d..b1c599d 100644 --- a/lib/libc/sys/wait.2 +++ b/lib/libc/sys/wait.2 @@ -32,7 +32,7 @@ .\" @(#)wait.2 8.2 (Berkeley) 4/19/94 .\" $FreeBSD$ .\" -.Dd April 19, 1994 +.Dd November 12, 2005 .Dt WAIT 2 .Os .Sh NAME @@ -234,25 +234,33 @@ see .Xr intro 2 , System call restart. .Pp -The implementation queues one SIGCHLD signal for each child process whose +The implementation queues one +.Dv SIGCHLD +signal for each child process whose status has changed, if .Fn wait returns because the status of a child process is available, the pending SIGCHLD signal associated with the process ID of the child process will -be discarded. Any other pending SIGCHLD signals remain pending. +be discarded. +Any other pending +.Dv SIGCHLD +signals remain pending. .Pp -If SIGCHLD is blocked, +If +.Dv SIGCHLD +is blocked, .Fn wait returns because the status of a child process is available, the pending -SIGCHLD signal will be cleared unless another status of the child process +.Dv SIGCHLD +signal will be cleared unless another status of the child process is available. .Sh RETURN VALUES If .Fn wait -returns due to a stopped, continued, +returns due to a stopped, continued, or terminated child process, the process ID of the child is returned to the calling process. -Otherwise, a value of -1 +Otherwise, a value of \-1 is returned and .Va errno is set to indicate the error. diff --git a/lib/libc/sys/write.2 b/lib/libc/sys/write.2 index 050e2a0..f1edb50 100644 --- a/lib/libc/sys/write.2 +++ b/lib/libc/sys/write.2 @@ -32,7 +32,7 @@ .\" @(#)write.2 8.5 (Berkeley) 4/2/94 .\" $FreeBSD$ .\" -.Dd October 16, 2004 +.Dd July 7, 2005 .Dt WRITE 2 .Os .Sh NAME diff --git a/lib/libedit/editline.3 b/lib/libedit/editline.3 index 1b864de..23d0015 100644 --- a/lib/libedit/editline.3 +++ b/lib/libedit/editline.3 @@ -108,7 +108,10 @@ .Ft void .Fn tok_reset "Tokenizer *t" .Ft int -.Fn tok_line "Tokenizer *t" "const LineInfo *li" "int *argc" "const char **argv[]" "int *cursorc" "int *cursoro" +.Fo tok_line +.Fa "Tokenizer *t" "const LineInfo *li" "int *argc" "const char **argv[]" +.Fa "int *cursorc" "int *cursoro" +.Fc .Ft int .Fn tok_str "Tokenizer *t" "const char *str" "int *argc" "const char **argv[]" .Sh DESCRIPTION @@ -192,7 +195,7 @@ to execute builtin .Nm commands. If the command is prefixed with -.Dq prog : +.Dq prog: then .Fn el_parse will only execute the command if @@ -396,7 +399,8 @@ This function is called internally by and .Fn el_getc . The builtin function can be set or restored with the special function -name ``EL_BUILTIN_GETCFN''. +name +.Dv EL_BUILTIN_GETCFN . .It Dv EL_CLIENTDATA , Fa "void *data" Register .Fa data @@ -438,7 +442,8 @@ above). Return non-zero if editing is enabled. .It Dv EL_GETCFN, Fa "int (**f)(EditLine *, char *)" Return a pointer to the function that read characters, which is equal to -``EL_BUILTIN_GETCFN'' in the case of the default builtin function. +.Dv EL_BUILTIN_GETCFN +in the case of the default builtin function. .It Dv EL_CLIENTDATA , Fa "void **data" Retrieve .Fa data @@ -649,7 +654,7 @@ The caller is responsible for free'ing the string in the returned .Pp The .Fn history -function returns \*[Gt]= 0 if the operation +function returns \*[Ge] 0 if the operation .Fa op succeeds. Otherwise, \-1 is returned and @@ -720,14 +725,12 @@ and .Aq newline . A positive exit code indicates that another line should be read and tokenization attempted again. -. .It Fn tok_str A simpler form of .Fn tok_line ; .Fa str is a NUL terminated string to tokenize. .El -. .\"XXX.Sh EXAMPLES .\"XXX: provide some examples .Sh SEE ALSO diff --git a/lib/libedit/editrc.5 b/lib/libedit/editrc.5 index 35d30cc..0624e18 100644 --- a/lib/libedit/editrc.5 +++ b/lib/libedit/editrc.5 @@ -231,7 +231,7 @@ Enable or disable the .Nm editline functionality in a program. .It Ic history Ar list | Ar size Dv n | Ar unique Dv n -The +The .Ar list command lists all entries in the history. The diff --git a/lib/libmd/sha256.3 b/lib/libmd/sha256.3 index c4acc7c..fb96100 100644 --- a/lib/libmd/sha256.3 +++ b/lib/libmd/sha256.3 @@ -9,7 +9,7 @@ .\" From: Id: mdX.3,v 1.14 1999/02/11 20:31:49 wollman Exp .\" $FreeBSD$ .\" -.Dd March 9, 2005 +.Dd September 14, 2005 .Dt SHA256 3 .Os .Sh NAME diff --git a/lib/libpmc/pmc.3 b/lib/libpmc/pmc.3 index a3925d8..6325c6e 100644 --- a/lib/libpmc/pmc.3 +++ b/lib/libpmc/pmc.3 @@ -191,7 +191,7 @@ information please see The function .Fn pmc_init initializes the -.Xr pmc 3 +.Nm pmc library. This function must be called first, before any of the other functions in the library. @@ -435,7 +435,7 @@ events. Event name aliases are CPU architecture independent names for commonly used events. The following aliases are known to this version of the -.Xr pmc 3 +.Nm pmc library: .Bl -tag -width indent .It Li branches @@ -3265,7 +3265,7 @@ is returned and the global variable is set to indicate the error. .Sh COMPATIBILITY The interface between the -.Xr pmc 3 +.Nm pmc library and the .Xr hwpmc 4 driver is intended to be private to the implementation and may @@ -3273,11 +3273,11 @@ change. In order to ease forward compatibility with future versions of the .Xr hwpmc 4 driver, applications are urged to dynamically link with the -.Xr pmc 3 +.Nm pmc library. .Pp The -.Xr pmc 3 +.Nm pmc API is .Ud .Sh ERRORS @@ -3295,7 +3295,7 @@ An unknown CPU type was encountered during initialization. The version number of the .Xr hwpmc 4 kernel module did not match that compiled into the -.Xr pmc 3 +.Nm pmc library. .El .Pp @@ -3323,7 +3323,7 @@ may fail with the following error: .Bl -tag -width Er .It Bq Er ENXIO The -.Xr pmc 3 +.Nm pmc has not been initialized. .El .Pp @@ -3335,7 +3335,7 @@ may fail with the following errors: The argument passed in was out of range. .It Bq Er ENXIO The -.Xr pmc 3 +.Nm pmc library has not been initialized. .El .Pp @@ -3346,7 +3346,7 @@ may fail with the following errors, in addition to those returned by .Bl -tag -width Er .It Bq Er ENXIO The -.Xr pmc 3 +.Nm pmc library is not yet initialized. .El .Pp @@ -3403,7 +3403,7 @@ driver. .Xr pmcstat 8 .Sh HISTORY The -.Xr pmc 3 +.Nm pmc library first appeared in .Fx 6.0 . .Sh BUGS diff --git a/lib/libpmc/pmclog.3 b/lib/libpmc/pmclog.3 index 7cf5f30..862f9cc 100644 --- a/lib/libpmc/pmclog.3 +++ b/lib/libpmc/pmclog.3 @@ -295,7 +295,7 @@ for a file based parser may fail with any of the errors returned by .Xr pmcstat 8 .Sh HISTORY The -.Xr pmclog 3 +.Nm pmclog API .Ud It first appeared in diff --git a/lib/msun/man/ieee_test.3 b/lib/msun/man/ieee_test.3 index 50ea23c..2727045 100644 --- a/lib/msun/man/ieee_test.3 +++ b/lib/msun/man/ieee_test.3 @@ -32,7 +32,7 @@ .\" from: @(#)ieee.3 6.4 (Berkeley) 5/6/91 .\" $FreeBSD$ .\" -.Dd Nov 6, 2005 +.Dd November 6, 2005 .Dt IEEE_TEST 3 .Os .Sh NAME diff --git a/lib/msun/man/ilogb.3 b/lib/msun/man/ilogb.3 index 1de5f8c..c840ded 100644 --- a/lib/msun/man/ilogb.3 +++ b/lib/msun/man/ilogb.3 @@ -32,7 +32,7 @@ .\" from: @(#)ieee.3 6.4 (Berkeley) 5/6/91 .\" $FreeBSD$ .\" -.Dd Nov 6, 2005 +.Dd November 6, 2005 .Dt ILOGB 3 .Os .Sh NAME diff --git a/lib/msun/man/math.3 b/lib/msun/man/math.3 index db3a666..4808532 100644 --- a/lib/msun/man/math.3 +++ b/lib/msun/man/math.3 @@ -32,7 +32,7 @@ .\" from: @(#)math.3 6.10 (Berkeley) 5/6/91 .\" $FreeBSD$ .\" -.Dd Nov 6, 2005 +.Dd November 6, 2005 .Dt MATH 3 .Os .if n \{\ -- cgit v1.1