-mdoc sweep.

2005-11-17 13:00:00 +00:00 · 2005-11-17 13:00:00 +00:00 · 110e1704d3
commit 110e1704d3
parent 218837618a
31 changed files with 79 additions and 59 deletions
--- 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.
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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.
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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.
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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
--- 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 \{\