 @@ -1,15 +1,18 @@
-.\" $NetBSD: ctime.3,v 1.38 2011/01/24 19:37:35 njoly Exp $
+.\" $NetBSD: ctime.3,v 1.39 2011/04/12 08:39:26 jruoho Exp $
-.Dd December 14, 2010
+.\"
 .\" XXX: Lincense missing?
 .\"
 .Dd April 12, 2011
 .Dt CTIME 3
 .Os
 .Sh NAME
 .Nm asctime ,
 .Nm asctime_r ,
 .Nm ctime ,
 .Nm ctime_r ,
 .Nm ctime_rz ,
 .Nm difftime ,
 .Nm gmtime ,
 .Nm gmtime_r ,
 .Nm localtime ,
 .Nm localtime_r ,
 @@ -93,27 +96,28 @@ argument, returned by a previous call to
 .Fn tzalloc .
 .Pp
 .Fn localtime
 and
 .Fn gmtime
 return pointers to
 .Va tm
 structures, described below.
 .Fn localtime
 corrects for the time zone and any time zone adjustments
 (such as Daylight Saving Time in the U.S.A.).
 After filling in the
 .Va tm
-structure,
+structure described in
 .Xr tm 3 ,
 .Fn localtime
 sets the
 .Fa tm_isdst Ns 'th
 element of
 .Fa tzname
 to a pointer to an
 ASCII string that's the time zone abbreviation to be used with
 .Fn localtime Ns 's
 return value.
 .Pp
 .Fn gmtime
 converts to Coordinated Universal Time.
 .Pp
 @@ -240,72 +244,26 @@ the call is equivalent to
 .Va tzname[0] .
 If
 .Fa isdst
 is set to
 .Va 1
 the call is equivalent to
 .Va tzname[1] .
 .Pp
 .Fn tzfree
 frees the
 .Fa tz
 argument previously returned by
 .Fa tzalloc .
 .Pp
 The structure (of type)
 .Va "struct tm"
 includes the following fields:
 .Bd -literal -offset indent
 int tm_sec;	/* seconds after the minute [0,61] */
 int tm_min;	/* minutes after the hour [0,59] */
 int tm_hour;	/* hours since midnight [0,23] */
 int tm_mday;	/* day of the month [1,31] */
 int tm_mon;	/* months since January [0,11] */
 int tm_year;	/* years since 1900 */
 int tm_wday;	/* day of week [0,6] (Sunday = 0) */
 int tm_yday;	/* day of year [0,365] (Jan 1 = 0) */
 int tm_isdst;	/* daylight savings flag */
 long tm_gmtoff;	/* offset from UTC in seconds */
 char *tm_zone;	/* abbreviation of timezone name */
 .Ed
 .Pp
 The
 .Fa tm_zone
 and
 .Fa tm_gmtoff
 fields exist, and are filled in, only if arrangements to do
 so were made when the library containing these functions was
 created.
 There is no guarantee that these fields will continue to exist
 in this form in future releases of this code.
 The
 .Fa tm_zone
 field will become invalid and point to freed storage if the corresponding
 .Va "struct tm"
 was returned by
 .Fn localtime_rz
 and the
 .Ft "const timezone_t"
 .Fa tz
 argument has been freed by
 .Fn tzfree .
 .Pp
 .Fa tm_isdst
 is non-zero if summer time is in effect.
 .Pp
 .Fa tm_gmtoff
 is the offset (in seconds) of the time represented
 from UTC, with positive values indicating east
 of the Prime Meridian.
 .Sh RETURN VALUES
 On success the
 .Fn asctime
 and
 .Fn ctime
 functions return a pointer to a static character buffer, and the
 .Fn asctime_r ,
 .Fn ctime_r ,
 and
 .Fn ctime_rz
 function return a pointer to the user-supplied buffer.
 On failure they all return
 .Dv NULL
 @@ -391,26 +349,27 @@ The result cannot be represented.
 The result cannot be represented.
 .El
 .Pp
 All functions that return values except their
 .Dq z
 variants, can also return the same errors as
 .Xr open 2
 and
 .Xr malloc 3 .
 .Sh SEE ALSO
 .Xr getenv 3 ,
 .Xr strftime 3 ,
 .Xr time 3 ,
 .Xr tm 3 ,
 .Xr tzset 3 ,
 .Xr tzfile 5
 .Sh STANDARDS
 The
 .Fn ctime ,
 .Fn difftime ,
 .Fn asctime ,
 .Fn localtime ,
 .Fn gmtime
 and
 .Fn mktime
 functions conform to
 .St -ansiC

 @@ -1,14 +1,14 @@
-.\" $NetBSD: timeval.3,v 1.11 2010/06/08 05:50:01 jruoho Exp $
+.\" $NetBSD: timeval.3,v 1.12 2011/04/12 08:39:26 jruoho Exp $
 .\"
 .\" Copyright (c) 2010 The NetBSD Foundation, Inc.
 .\" All rights reserved.
 .\"
 .\" This code is derived from software contributed to The NetBSD Foundation
 .\" by Jukka Ruohonen.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 @@ -17,27 +17,27 @@
 .\"
 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd June 8, 2010
+.Dd April 12, 2011
 .Dt TIMEVAL 3
 .Os
 .Sh NAME
 .Nm timeval ,
 .Nm timespec ,
 .Nm itimerval ,
 .Nm itimerspec ,
 .Nm bintime
 .Nd time structures
 .Sh SYNOPSIS
 .In sys/time.h
 .Ft void
 .Fn TIMEVAL_TO_TIMESPEC "struct timeval *tv" "struct timespec *ts"
 @@ -175,14 +175,15 @@ example(struct timespec *spec, time_t mi
 	_DIAGASSERT(spec != NULL);
 	TIMEVAL_TO_TIMESPEC(&elapsed, spec);
 	/* Add the offset for timeout in minutes. */
 	spec->tv_sec = spec->tv_sec + minutes * 60;
+}
 .Ed
 .Pp
 A better alternative would use the more precise
 .Xr clock_gettime 2 .
 .Sh SEE ALSO
 .Xr timeradd 3 ,
 .Xr tm 3 ,
 .Xr bintime_add 9

 @@ -1,14 +1,14 @@
-.\" $NetBSD: tm.3,v 1.1 2011/04/12 08:22:49 jruoho Exp $
+.\" $NetBSD: tm.3,v 1.2 2011/04/12 08:39:26 jruoho Exp $
 .\"
 .\" Copyright (c) 2011 Jukka Ruohonen <jruohonen@iki.fi>
 .\" All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
 .\"
 @@ -72,20 +72,48 @@ The members are:
 The
 .Vt tm
 structure is used by various common library routines such as
 .Xr mktime 3 ,
 .Xr localtime 3 ,
 and
 .Xr strptime 3 .
 All except
 .Va tm_gmtoff
 and
 .Va tm_zone
 are defined in
 .St -p1003.1-2008 .
 .Ss NetBSD Extensions
 The
 .Va tm_zone
 and
 .Va tm_gmtoff
 fields exist, and are filled in by applicable library routines,
 only if arrangements to do so were made when the library containing
 these functions was created.
 There is no guarantee that these fields will continue to exist
 in this form in future releases of
 . Nx .
 .Pp
 The
 .Fa tm_gmtoff
 field denotes the offset (in seconds) of the time represented
 from UTC, with positive values indicating east
 of the Prime Meridian.
 The
 .Vt tm_zone
 field will become invalid and point to freed storage if the corresponding
 .Va "struct tm"
 was returned by
 .Xr localtime_rz 3
 and the
 .Ft "const timezone_t"
 .Fa tz
 argument has been freed by
 .Xr tzfree 3 .
 .Sh SEE ALSO
 .Xr timeval 3
 .Sh STANDARDS
 The
 .Vt tm
 structure conforms to
 .St -p1003.1-2008 .