Source-Changes-HG archive

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]

[src/trunk]: src Add a small summary parge for struct tm from <time.h>. Cf. t...



details:   https://anonhg.NetBSD.org/src/rev/ba7526a61abc
branches:  trunk
changeset: 764140:ba7526a61abc
user:      jruoho <jruoho%NetBSD.org@localhost>
date:      Tue Apr 12 08:22:48 2011 +0000

description:
Add a small summary parge for struct tm from <time.h>. Cf. timeval(3).

diffstat:

 distrib/sets/lists/comp/mi |   5 ++-
 share/man/man3/Makefile    |   4 +-
 share/man/man3/tm.3        |  91 ++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 97 insertions(+), 3 deletions(-)

diffs (146 lines):

diff -r b65e9751b3af -r ba7526a61abc distrib/sets/lists/comp/mi
--- a/distrib/sets/lists/comp/mi        Tue Apr 12 07:54:16 2011 +0000
+++ b/distrib/sets/lists/comp/mi        Tue Apr 12 08:22:48 2011 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: mi,v 1.1613 2011/04/10 09:58:00 jruoho Exp $
+#      $NetBSD: mi,v 1.1614 2011/04/12 08:22:48 jruoho Exp $
 #
 # Note: don't delete entries from here - mark them as "obsolete" instead.
 #
@@ -8596,6 +8596,7 @@
 ./usr/share/man/cat3/timespecsub.0             comp-c-catman           .cat
 ./usr/share/man/cat3/timeval.0                 comp-c-catman           .cat
 ./usr/share/man/cat3/timezone.0                        comp-c-catman           .cat
+./usr/share/man/cat3/tm.0                      comp-c-catman           .cat
 ./usr/share/man/cat3/tmpfile.0                 comp-c-catman           .cat
 ./usr/share/man/cat3/tmpnam.0                  comp-c-catman           .cat
 ./usr/share/man/cat3/toascii.0                 comp-c-catman           .cat
@@ -14603,6 +14604,7 @@
 ./usr/share/man/html3/timespecsub.html         comp-c-htmlman          html
 ./usr/share/man/html3/timeval.html             comp-c-htmlman          html
 ./usr/share/man/html3/timezone.html            comp-c-htmlman          html
+./usr/share/man/html3/tm.html                  comp-c-htmlman          html
 ./usr/share/man/html3/tmpfile.html             comp-c-htmlman          html
 ./usr/share/man/html3/tmpnam.html              comp-c-htmlman          html
 ./usr/share/man/html3/toascii.html             comp-c-htmlman          html
@@ -20678,6 +20680,7 @@
 ./usr/share/man/man3/timespecsub.3             comp-c-man              .man
 ./usr/share/man/man3/timeval.3                 comp-c-man              .man
 ./usr/share/man/man3/timezone.3                        comp-c-man              .man
+./usr/share/man/man3/tm.3                      comp-c-man              .man
 ./usr/share/man/man3/tmpfile.3                 comp-c-man              .man
 ./usr/share/man/man3/tmpnam.3                  comp-c-man              .man
 ./usr/share/man/man3/toascii.3                 comp-c-man              .man
diff -r b65e9751b3af -r ba7526a61abc share/man/man3/Makefile
--- a/share/man/man3/Makefile   Tue Apr 12 07:54:16 2011 +0000
+++ b/share/man/man3/Makefile   Tue Apr 12 08:22:48 2011 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: Makefile,v 1.74 2011/04/10 09:58:01 jruoho Exp $
+#      $NetBSD: Makefile,v 1.75 2011/04/12 08:22:49 jruoho Exp $
 #      @(#)Makefile    8.2 (Berkeley) 12/13/93
 
 MAN=   _DIAGASSERT.3 __CONCAT.3 __UNCONST.3 CMSG_DATA.3 \
@@ -12,7 +12,7 @@
        ilog2.3 intro.3 inttypes.3 iso646.3 \
        makedev.3 offsetof.3 param.3 paths.3 queue.3 rbtree.3 sigevent.3 \
        stdarg.3 stdbool.3 stddef.3 stdint.3 stdlib.3 sysexits.3 \
-       tgmath.3 timeradd.3 timeval.3 tree.3 typeof.3 types.3 \
+       tgmath.3 timeradd.3 timeval.3 tm.3 tree.3 typeof.3 types.3 \
        unistd.3 varargs.3
 
 USETBL=        # used by queue.3
diff -r b65e9751b3af -r ba7526a61abc share/man/man3/tm.3
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man3/tm.3       Tue Apr 12 08:22:48 2011 +0000
@@ -0,0 +1,91 @@
+.\" $NetBSD: tm.3,v 1.1 2011/04/12 08:22:49 jruoho Exp $
+.\"
+.\" Copyright (c) 2011 Jukka Ruohonen <jruohonen%iki.fi@localhost>
+.\" 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.
+.\"
+.\" 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 April 12, 2011
+.Dt TM 3
+.Os
+.Sh NAME
+.Nm tm
+.Nd time structure
+.Sh SYNOPSIS
+.In time.h
+.Sh DESCRIPTION
+The
+.In time.h
+header defines the following structure:
+.Bd -literal -offset indent
+struct tm {
+       int              tm_sec;
+       int              tm_min;
+       int              tm_hour;
+       int              tm_mday;
+       int              tm_mon;
+       int              tm_year;
+       int              tm_wday;
+       int              tm_yday;
+       int              tm_isdst;
+       long             tm_gmtoff;
+       __aconst char   *tm_zone;
+};
+.Ed
+.Pp
+The members are:
+.Bl -column -offset indent \
+"Member  " "Months since January 1     "  "Range "
+.It Sy Member Ta Sy Represents Ta Sy Range
+.It Va tm_sec Ta Seconds Ta [0, 61]
+.It Va tm_min Ta Minutes Ta [0, 59]
+.It Va tm_hour Ta Hours since midnight Ta [0, 23]
+.It Va tm_mday Ta Day of the month Ta [1, 31]
+.It Va tm_mon Ta Months since January Ta [0, 11]
+.It Va tm_year Ta Years since 1900 Ta
+.It Va tm_wday Ta Days since Sunday Ta [0,  6]
+.It Va tm_yday Ta Days since January 1 Ta [0, 365]
+.It Va tm_isdt Ta Positive if daylight savings Ta >= 0
+.It Va tm_gmtoff Ta Offset from UTC in seconds Ta
+.It Va tm_zone Ta Timezone abbreviation
+.El
+.Pp
+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 .
+.Sh SEE ALSO
+.Xr timeval 3
+.Sh STANDARDS
+The
+.Vt tm
+structure conforms to
+.St -p1003.1-2008 .



Home | Main Index | Thread Index | Old Index