- sync prototypes and header excerpts to reality

- punctuation, rewording, typos/spelling, macro, and layout fixes
- add crossrefs where relevant

ok jmc

7 files changed, 44 insertions, 40 deletions

diff --git a/lib/libc/nls/catgets.3 b/lib/libc/nls/catgets.3
index b5100422336..aac640401cd 100644
--- a/lib/libc/nls/catgets.3
+++ b/lib/libc/nls/catgets.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: catgets.3,v 1.4 1999/08/31 16:52:34 aaron Exp $
+.\"	$OpenBSD: catgets.3,v 1.5 2005/07/22 03:23:36 jaredy Exp $
 .\"
 .\" Written by J.T. Conklin <jtc@netbsd.org>.
 .\" Public domain.
@@ -12,7 +12,7 @@
 .Sh SYNOPSIS
 .Fd #include <nl_types.h>
 .Ft char *
-.Fn catgets "nl_catd catd" "int set_id" "int msg_id" "char *s"
+.Fn catgets "nl_catd catd" "int set_id" "int msg_id" "const char *s"
 .Sh DESCRIPTION
 The
 .Fn catgets
diff --git a/lib/libc/ohash/ohash_init.3 b/lib/libc/ohash/ohash_init.3
index 5d572d13f26..39da2e7303a 100644
--- a/lib/libc/ohash/ohash_init.3
+++ b/lib/libc/ohash/ohash_init.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: ohash_init.3,v 1.10 2005/02/25 03:12:43 cloder Exp $
+.\"	$OpenBSD: ohash_init.3,v 1.11 2005/07/22 03:23:37 jaredy Exp $
 .\" Copyright (c) 1999 Marc Espie <espie@openbsd.org>
 .\"
 .\" Permission to use, copy, modify, and distribute this software for any
@@ -53,7 +53,7 @@
 .Ft "unsigned int"
 .Fn ohash_entries "struct ohash *h"
 .Sh DESCRIPTION
-Those functions have been designed as a fast, extensible alternative to
+These functions have been designed as a fast, extensible alternative to
 the usual hash table functions.
 They provide storage and retrieval of records indexed by keys,
 where a key is a contiguous sequence of bytes at a fixed position in
diff --git a/lib/libc/rpc/xdr.3 b/lib/libc/rpc/xdr.3
index b2197cec4e0..c4e37cd3421 100644
--- a/lib/libc/rpc/xdr.3
+++ b/lib/libc/rpc/xdr.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: xdr.3,v 1.16 2003/08/08 09:26:02 jmc Exp $
+.\"	$OpenBSD: xdr.3,v 1.17 2005/07/22 03:23:37 jaredy Exp $
 .\" Mostly converted to mandoc by Theo de Raadt, Tue Feb 24 04:04:46 MST 1998
 .\"
 .\" Sun RPC is a product of Sun Microsystems, Inc. and is provided for
@@ -316,7 +316,7 @@ This routine returns one if it succeeds, zero otherwise.
 .Fn xdr_pointer
 is like
 .Fn xdr_reference
-execpt that it serializes
+except that it serializes
 .Dv NULL
 pointers, whereas
 .Fn xdr_reference
diff --git a/lib/libc/time/ctime.3 b/lib/libc/time/ctime.3
index f262932ab41..8f8a6fa4018 100644
--- a/lib/libc/time/ctime.3
+++ b/lib/libc/time/ctime.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: ctime.3,v 1.30 2005/07/05 13:40:51 millert Exp $
+.\"	$OpenBSD: ctime.3,v 1.31 2005/07/22 03:23:37 jaredy Exp $
 .\"
 .\"
 .Dd February 16, 1999
@@ -151,7 +151,7 @@ returns
 converts the broken-down time,
 expressed as local time,
 in the structure pointed to by
-.Li tm
+.Fa tm
 into a calendar time value with the same encoding as that of the values
 returned by the
 .Fn time
@@ -168,7 +168,7 @@ to their normal ranges.
 causes
 .Fn mktime
 to presume initially that summer time (for example, Daylight Saving Time
-in the U.S.A.)
+in the U.S.A.)\&
 respectively,
 is or is not in effect for the specified time.
 A negative value for
@@ -232,8 +232,8 @@ includes the following fields:
 	int tm_wday;	/* day of week (Sunday = 0) */
 	int tm_yday;	/* day of year (0 \- 365) */
 	int tm_isdst;	/* is summer time in effect? */
-	char *tm_zone;	/* abbreviation of timezone name */
 	long tm_gmtoff;	/* offset from UTC in seconds */
+	char *tm_zone;	/* abbreviation of timezone name */
 .Ed
 .Pp
 The
diff --git a/lib/libc/time/strftime.3 b/lib/libc/time/strftime.3
index aebca699d24..f85a02be7cd 100644
--- a/lib/libc/time/strftime.3
+++ b/lib/libc/time/strftime.3
@@ -30,7 +30,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     from: @(#)strftime.3    5.12 (Berkeley) 6/29/91
-.\"	$OpenBSD: strftime.3,v 1.19 2004/04/14 07:56:40 otto Exp $
+.\"	$OpenBSD: strftime.3,v 1.20 2005/07/22 03:23:37 jaredy Exp $
 .\"
 .Dd January 18, 1998
 .Dt STRFTIME 3
@@ -85,16 +85,16 @@ is replaced by the locale's full month name.
 is replaced by the locale's abbreviated month name.
 .It Cm \&%C
 is replaced by the century (a year divided by 100 and truncated to an integer)
-as a decimal number (00-99).
+as a decimal number (00\-99).
 .It Cm \&%c
 is replaced by the locale's appropriate date and time representation.
 .It Cm \&%D
 is replaced by the date in the format
 .Dq Li %m/%d/%y .
 .It Cm \&%d
-is replaced by the day of the month as a decimal number (01-31).
+is replaced by the day of the month as a decimal number (01\-31).
 .It Cm \&%e
-is replaced by the day of month as a decimal number (1-31);
+is replaced by the day of month as a decimal number (1\-31);
 single digits are preceded by a blank.
 .It Cm \&%F
 is replaced by the date in the format
@@ -102,23 +102,23 @@ is replaced by the date in the format
 .It Cm \&%G
 is replaced by the ISO 8601 year with century as a decimal number.
 .It Cm \&%g
-is replaced by the ISO 8601 year without century as a decimal number (00-99).
+is replaced by the ISO 8601 year without century as a decimal number (00\-99).
 .It Cm \&%H
-is replaced by the hour (24-hour clock) as a decimal number (00-23).
+is replaced by the hour (24-hour clock) as a decimal number (00\-23).
 .It Cm \&%I
-is replaced by the hour (12-hour clock) as a decimal number (01-12).
+is replaced by the hour (12-hour clock) as a decimal number (01\-12).
 .It Cm \&%j
-is replaced by the day of the year as a decimal number (001-366).
+is replaced by the day of the year as a decimal number (001\-366).
 .It Cm \&%k
-is replaced by the hour (24-hour clock) as a decimal number (0-23);
+is replaced by the hour (24-hour clock) as a decimal number (0\-23);
 single digits are preceded by a blank.
 .It Cm \&%l
-is replaced by the hour (12-hour clock) as a decimal number (1-12);
+is replaced by the hour (12-hour clock) as a decimal number (1\-12);
 single digits are preceded by a blank.
 .It Cm \&%M
-is replaced by the minute as a decimal number (00-59).
+is replaced by the minute as a decimal number (00\-59).
 .It Cm %m
-is replaced by the month as a decimal number (01-12).
+is replaced by the month as a decimal number (01\-12).
 .It Cm %n
 is replaced by a newline.
 .It Cm %p
@@ -133,9 +133,9 @@ is replaced by the time in the format
 is replaced by the locale's representation of 12-hour clock time
 using AM/PM notation.
 .It Cm \&%S
-is replaced by the second as a decimal number (00-61).
+is replaced by the second as a decimal number (00\-61).
 The range of
-seconds is (00-61) instead of (00-59) to allow for the periodic occurrence
+seconds is (00\-61) instead of (00\-59) to allow for the periodic occurrence
 of leap seconds and double leap seconds.
 .It Cm %s
 is replaced by the number of seconds since the Epoch, UTC (see
@@ -147,13 +147,13 @@ is replaced by the time in the format
 is replaced by a tab.
 .It Cm \&%U
 is replaced by the week number of the year (Sunday as the first day of
-the week) as a decimal number (00-53).
+the week) as a decimal number (00\-53).
 .It Cm \&%u
 is replaced by the weekday (Monday as the first day of the week)
-as a decimal number (1-7).
+as a decimal number (1\-7).
 .It Cm \&%V
 is replaced by the week number of the year (Monday as the first day of
-the week) as a decimal number (01-53).
+the week) as a decimal number (01\-53).
 If the week containing January
 1 has four or more days in the new year, then it is week 1; otherwise
 it is week 53 of the previous year, and the next week is week 1.
@@ -162,10 +162,10 @@ is replaced by the date in the format
 .Dq Li "%e-%b-%Y" .
 .It Cm \&%W
 is replaced by the week number of the year (Monday as the first day of
-the week) as a decimal number (00-53).
+the week) as a decimal number (00\-53).
 .It Cm \&%w
 is replaced by the weekday (Sunday as the first day of the week)
-as a decimal number (0-6).
+as a decimal number (0\-6).
 .It Cm \&%X
 is replaced by the locale's appropriate time representation.
 .It Cm \&%x
@@ -173,7 +173,7 @@ is replaced by the locale's appropriate date representation.
 .It Cm \&%Y
 is replaced by the year with century as a decimal number.
 .It Cm \&%y
-is replaced by the year without century as a decimal number (00-99).
+is replaced by the year without century as a decimal number (00\-99).
 .It Cm \&%Z
 is replaced by the time zone name,
 or by the empty string if this is not determinable.
diff --git a/lib/libc/time/strptime.3 b/lib/libc/time/strptime.3
index ce383afb969..36acc1f4124 100644
--- a/lib/libc/time/strptime.3
+++ b/lib/libc/time/strptime.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: strptime.3,v 1.8 2003/05/07 08:52:42 jmc Exp $
+.\"	$OpenBSD: strptime.3,v 1.9 2005/07/22 03:23:37 jaredy Exp $
 .\"
 .\" Copyright (c) 1997, 1998 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -58,16 +58,21 @@ The
 string consists of zero or more directives.
 A directive is composed of either one or more whitespace characters as
 defined by
-.Fn isspace ,
-an ordinary character (neither `%' nor a whitespace), or a conversion
+.Xr isspace 3 ,
+an ordinary character (neither
+.Sq %
+nor a whitespace), or a conversion
 specification.
-A conversion specification consists of a percent sign `%'
+A conversion specification consists of a percent sign
+.Pq Sq %
 followed by one or two conversion characters which specify the
 replacement required.
 There must be whitespace or other
 non-alphanumeric characters between any two conversion specifications.
 .Pp
-The LC_TIME category defines the locale values for the conversion
+The
+.Dv LC_TIME
+category defines the locale values for the conversion
 specifications.
 The following conversion specifications are supported:
 .Bl -tag -width "xxxx"
@@ -159,8 +164,8 @@ the time, using the locale's time format.
 .It Cm \&%y
 the year within the current century.
 When a century is not otherwise
-specified, values in the range 69-99 refer to years in the twentieth
-century (1969 to 1999 inclusive); values in the range 00-68 refer
+specified, values in the range 69\-99 refer to years in the twentieth
+century (1969 to 1999 inclusive); values in the range 00\-68 refer
 to years in the twenty-first century (2000 to 2068 inclusive).
 Leading zeros are permitted but not required.
 .It Cm \&%Y
diff --git a/lib/libc/time/time2posix.3 b/lib/libc/time/time2posix.3
index 80229cea54f..107d39ddfd2 100644
--- a/lib/libc/time/time2posix.3
+++ b/lib/libc/time/time2posix.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: time2posix.3,v 1.12 2005/07/19 15:51:29 millert Exp $
+.\"	$OpenBSD: time2posix.3,v 1.13 2005/07/22 03:23:37 jaredy Exp $
 .Dd May 24, 1999
 .Dt TIME2POSIX 3
 .Os
@@ -14,8 +14,7 @@
 .Ft time_t
 .Fn posix2time "time_t t"
 .Sh DESCRIPTION
-IEEE Standard 1003.1
-(POSIX)
+.St -p1003.1
 legislates that a
 .Fa time_t
 value of