From owner-freebsd-doc  Wed Apr 29 04:30:04 1998
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Received: (from majordom@localhost)
          by hub.freebsd.org (8.8.8/8.8.8) id EAA03679
          for freebsd-doc-outgoing; Wed, 29 Apr 1998 04:30:04 -0700 (PDT)
          (envelope-from owner-freebsd-doc@FreeBSD.ORG)
Received: (from gnats@localhost)
          by hub.freebsd.org (8.8.8/8.8.8) id EAA03610;
          Wed, 29 Apr 1998 04:30:02 -0700 (PDT)
          (envelope-from gnats)
Received: from mail.yk.rim.or.jp (root@mail.yk.rim.or.jp [202.247.130.37])
          by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id EAA02164
          for <FreeBSD-gnats-submit@freebsd.org>; Wed, 29 Apr 1998 04:21:30 -0700 (PDT)
          (envelope-from k-horik@yk.rim.or.jp)
Received: from localhost (ppp126.yk.rim.or.jp [202.247.134.126]) by mail.yk.rim.or.jp (8.8.5/3.4Wbeta6-rim1.1) with ESMTP id UAA15692; Wed, 29 Apr 1998 20:21:27 +0900 (JST)
Message-Id: <19980429202113Y.k-horik@yk.rim.or.jp>
Date: Wed, 29 Apr 1998 20:21:13 +0900
From: horikawa@jp.freebsd.org
Reply-To: horikawa@jp.freebsd.org
To: FreeBSD-gnats-submit@FreeBSD.ORG
X-Send-Pr-Version: 3.2
Subject: docs/6454: In tzfile.5, tzfile.h does not exist, and tzh_timecnt is misused.
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


>Number:         6454
>Category:       docs
>Synopsis:       In tzfile.5, tzfile.h does not exist, and tzh_timecnt is misused.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:
>Keywords:
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Apr 29 04:30:01 PDT 1998
>Last-Modified:
>Originator:     Kazuo Horikawa
>Organization:
personal user
>Release:        FreeBSD 2.2.5-RELEASE i386
>Environment:

	2.2.5-RELEASE and 2.2.6-RELEASE

>Description:

	1) /usr/include/tzfile.h does not exist.  But tzfile.5 shows:

SYNOPSIS
     #include <tzfile.h>

	  I searched tzfile.h using `find / -name tzfile.h', but I can
	  not find it.


	2) tzh_timecnt is misused for tzh_typecnt.  The tzfile.5 shows:

     tzh_timecnt     The number of ``transition times'' for which data is
                     stored in the file.
     tzh_typecnt     The number of ``local time types'' for which data is
                     stored in the file (must not be zero).
[snip]
     The above header is followed by tzh_timecnt four-byte values of type
     long, sorted in ascending order.  These values are written in ``stan-
     dard'' byte order.  Each is used as a transition time (as returned by
     time(3))  at which the rules for computing local time change.  Next come
     tzh_timecnt one-byte values of type unsigned char; each one tells which
     ^^^^^^^^^^^
	I think this should be tzh_typecnt.
    
     of the different types of ``local time'' types described in the file is
     associated with the same-indexed transition time.  These values serve as
     indices into an array of ttinfo structures that appears next in the file;
     these structures are defined as follows:
	

>How-To-Repeat:

	`man 5 tzfile' on 2.2.5-RELEASE or 2.2.6-RELEASE.

>Fix:

--- tzfile.5.bak	Wed Apr 29 20:09:33 1998
+++ tzfile.5	Wed Apr 29 20:10:06 1998
@@ -4,8 +4,6 @@
 .Sh NAME
 .Nm tzfile
 .Nd timezone information
-.Sh SYNOPSIS
-.Fd #include <tzfile.h>
 .Sh DESCRIPTION
 The time zone information files used by
 .Xr tzset 3
@@ -43,7 +41,7 @@
 .Xr time 3 )
 at which the rules for computing local time change.
 Next come
-.Li tzh_timecnt
+.Li tzh_typecnt
 one-byte values of type
 .Fa "unsigned char" ;
 each one tells which of the different types of ``local time'' types

>Audit-Trail:
>Unformatted:

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message