summaryrefslogtreecommitdiffstats
path: root/lib/libc/time
diff options
context:
space:
mode:
authoraaron <aaron@openbsd.org>2000-10-18 05:12:06 +0000
committeraaron <aaron@openbsd.org>2000-10-18 05:12:06 +0000
commitea418ffe85da8239e30bb1c3e28466cf6b8f685e (patch)
tree01651b197bba18ec88ec6a378fec58207d2f3632 /lib/libc/time
parentget the bounds checking right for the data used in copyout() in several (diff)
downloadwireguard-openbsd-ea418ffe85da8239e30bb1c3e28466cf6b8f685e.tar.xz
wireguard-openbsd-ea418ffe85da8239e30bb1c3e28466cf6b8f685e.zip
Another round of man page cleanup, this time to remove more hard sentence
breaks and getting rid of short lines, making these files easier to work with.
Diffstat (limited to 'lib/libc/time')
-rw-r--r--lib/libc/time/strftime.324
-rw-r--r--lib/libc/time/strptime.327
-rw-r--r--lib/libc/time/tzset.345
-rw-r--r--lib/libc/time/zic.88
4 files changed, 63 insertions, 41 deletions
diff --git a/lib/libc/time/strftime.3 b/lib/libc/time/strftime.3
index eee1d0bbc9c..b858b5c6c76 100644
--- a/lib/libc/time/strftime.3
+++ b/lib/libc/time/strftime.3
@@ -34,7 +34,7 @@
.\" SUCH DAMAGE.
.\"
.\" from: @(#)strftime.3 5.12 (Berkeley) 6/29/91
-.\" $OpenBSD: strftime.3,v 1.11 2000/09/06 23:05:11 millert Exp $
+.\" $OpenBSD: strftime.3,v 1.12 2000/10/18 05:12:12 aaron Exp $
.\"
.Dd January 18, 1998
.Dt STRFTIME 3
@@ -154,7 +154,8 @@ is replaced by the weekday (Monday as the first day of the week)
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). If the week containing January
+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.
.It Cm \&%W
@@ -215,15 +216,17 @@ and
conversion specifications are extensions.
.Pp
Use of the ISO 8601 conversions may produce non-intuitive results.
-Week 01 of a year is per definition the first week which has the
-Thursday in this year, which is equivalent to the week which contains
-the fourth day of January. In other words, the first week of a new
-year is the week which has the majority of its days in the new year.
+Week 01 of a year is per definition the first week which has the Thursday
+in this year, which is equivalent to the week which contains the fourth
+day of January.
+In other words, the first week of a new year is the week which has the
+majority of its days in the new year.
Week 01 might also contain days from the previous year and the week
before week 01 of a year is the last week (52 or 53) of the previous
-year even if it contains days from the new year. A week starts with
-Monday (day 1) and ends with Sunday (day 7). For example, the first
-week of the year 1997 lasts from 1996-12-30 to 1997-01-05.
+year even if it contains days from the new year.
+A week starts with Monday (day 1) and ends with Sunday (day 7).
+For example, the first week of the year 1997 lasts from
+1996-12-30 to 1997-01-05.
.Sh BUGS
There is no conversion specification for the phase of the moon.
.Pp
@@ -233,7 +236,8 @@ will always NUL terminate
.Fa buf ,
other implementations may not do so when
.Fa maxsiz
-is not large enough to store the entire time string. The contents of
+is not large enough to store the entire time string.
+The contents of
.Fa buf
are implementation specific in this case.
.\" @(#)newstrftime.3 7.14
diff --git a/lib/libc/time/strptime.3 b/lib/libc/time/strptime.3
index ac055129b88..771bc06b8c3 100644
--- a/lib/libc/time/strptime.3
+++ b/lib/libc/time/strptime.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: strptime.3,v 1.6 2000/03/04 22:19:32 aaron Exp $
+.\" $OpenBSD: strptime.3,v 1.7 2000/10/18 05:12:12 aaron Exp $
.\"
.\" Copyright (c) 1997, 1998 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -55,17 +55,20 @@ using the format specified by
.Pp
The
.Fa format
-string consists of zero or more directives. A directive is composed
-of either one or more whitespace as defined by
+string consists of zero or more directives.
+A directive is composed of either one or more whitespace as defined by
.Fn isspace ,
an ordinary character (neither `%' nor a whitespace), or a conversion
-specification. A conversion specification consists of a percent sign `%'
+specification.
+A conversion specification consists of a percent sign `%'
followed by one or two conversion characters which specify the
-replacement required. There must be whitespace or other
+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
-specifications. The following conversion specifications are supported:
+specifications.
+The following conversion specifications are supported:
.Bl -tag -width "xxxx"
.It Cm \&%a
the day of week, using the locale's weekday names;
@@ -150,7 +153,8 @@ the date, using the locale's date format.
.It Cm \&%X
the time, using the locale's time format.
.It Cm \&%y
-the year within the current century. When a century is not otherwise
+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
to years in the twenty-first century (2000 to 2068 inclusive).
@@ -158,7 +162,8 @@ Leading zeros are permitted but not required.
.It Cm \&%Y
the year, including the century (i.e., 1998).
.It Cm \&%%
-A `%' is written. No argument is converted.
+A `%' is written.
+No argument is converted.
.El
.Ss Modified conversion specifications
For compatibility, certain conversion specifications can be modified
@@ -168,7 +173,8 @@ and
.Cm O
modifier characters to indicate that an alternative format or
specification should be used rather than the one normally used by the
-unmodified conversion specification. As there are currently neither
+unmodified conversion specification.
+As there are currently neither
alternative formats nor specifications supported by the system, the
behavior will be as if the unmodified conversion specification were
used.
@@ -180,7 +186,8 @@ such as month and weekday names.
If successful, the
.Nm
function returns a pointer to the character following the last character
-parsed. Otherwise, a null pointer is returned.
+parsed.
+Otherwise, a null pointer is returned.
.Sh SEE ALSO
.Xr strftime 3
.Sh STANDARDS
diff --git a/lib/libc/time/tzset.3 b/lib/libc/time/tzset.3
index daafc4533e7..09511907565 100644
--- a/lib/libc/time/tzset.3
+++ b/lib/libc/time/tzset.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: tzset.3,v 1.11 1999/07/09 13:35:21 aaron Exp $
+.\" $OpenBSD: tzset.3,v 1.12 2000/10/18 05:12:13 aaron Exp $
.Dd May 24, 1999
.Dt TZSET 3
.Os
@@ -73,13 +73,14 @@ Three or more bytes that are the designation for the standard
.Pq Ar std
or summer
.Pq Ar dst
-time zone. Only
+time zone.
+Only
.Ar std
is required; if
.Ar dst
is missing, then summer time does not apply in this locale.
-Upper and lowercase letters are explicitly allowed. Any characters
-except a leading colon
+Upper and lowercase letters are explicitly allowed.
+Any characters except a leading colon
.Pq Sq \&: ,
digits, comma
.Pq Sq \&, ,
@@ -106,20 +107,25 @@ The minutes
.Pq Ar mm
and seconds
.Pq Ar ss
-are optional. The hour
+are optional.
+The hour
.Pq Ar hh
-is required and may be a single digit. The
+is required and may be a single digit.
+The
.Ar offset
following
.Ar std
-is required. If no
+is required.
+If no
.Ar offset
follows
.Ar dst ,
-summer time is assumed to be one hour ahead of standard time. One or
-more digits may be used; the value is always interpreted as a decimal
-number. The hour must be between zero and 24, and the minutes (and
-seconds) -- if present -- between zero and 59. If preceded by a
+summer time is assumed to be one hour ahead of standard time.
+One or more digits may be used; the value is always interpreted as a
+decimal number.
+The hour must be between zero and 24, and the minutes (and
+seconds) -- if present -- between zero and 59.
+If preceded by a
.Dq \&- ,
the time zone shall be east of the Prime Meridian; otherwise it shall be
west (which may be indicated by an optional preceding
@@ -143,7 +149,8 @@ where the first
describes when the change from standard to summer time occurs and the
second
.Ar date
-describes when the change back happens. Each
+describes when the change back happens.
+Each
.Ar time
field describes when, in current local time, the change to the other
time is made.
@@ -161,8 +168,8 @@ The Julian day
\&<\&= 365
.Pc .
Leap days are not counted; that is, in all years -- including leap
-years -- February 28 is day 59 and March 1 is day 60. It is
-impossible to explicitly refer to the occasional February 29.
+years -- February 28 is day 59 and March 1 is day 60.
+It is impossible to explicitly refer to the occasional February 29.
.It Ar n
The zero-based Julian day
.Po
@@ -202,10 +209,11 @@ the last
day in month
.Ar m
.Dc
-which may occur in either the fourth or the fifth week. Week 1 is the
-first week in which the
+which may occur in either the fourth or the fifth week.
+Week 1 is the first week in which the
.Ar d Ns th
-day occurs. Day zero is Sunday.
+day occurs.
+Day zero is Sunday.
.El
.Pp
The
@@ -218,7 +226,8 @@ except that no leading sign
or
.Dq \&+
.Pc
-is allowed. The default, if
+is allowed.
+The default, if
.Ar time
is not given, is
.Cm 02:00:00 .
diff --git a/lib/libc/time/zic.8 b/lib/libc/time/zic.8
index f442ff3f1a4..e5e8f7fbcd0 100644
--- a/lib/libc/time/zic.8
+++ b/lib/libc/time/zic.8
@@ -1,4 +1,4 @@
-.\" $OpenBSD: zic.8,v 1.12 2000/04/16 16:24:04 d Exp $
+.\" $OpenBSD: zic.8,v 1.13 2000/10/18 05:12:13 aaron Exp $
.Dd May 23, 1999
.Dt ZIC 8
.Os
@@ -120,7 +120,8 @@ may be used to repeat the value of the
.Em FROM
field.
.It Cm TYPE
-Gives the type of year in which the rule applies. If
+Gives the type of year in which the rule applies.
+If
.Em TYPE
is
.Dq Fl
@@ -128,7 +129,8 @@ then the rule applies in all years between
.Em FROM
and
.Em TO
-inclusive. If
+inclusive.
+If
.Em TYPE
is something else, then
.Nm