From k-horik@yk.rim.or.jp  Wed Apr 29 04:21:31 1998
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
Sender: Kazuo Horikawa <k-horik@yk.rim.or.jp>
Reply-To: horikawa@jp.freebsd.org
To: FreeBSD-gnats-submit@freebsd.org
Subject: In tzfile.5, tzfile.h does not exist, and tzh_timecnt is misused.
X-Send-Pr-Version: 3.2

>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:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Apr 29 04:30:01 PDT 1998
>Closed-Date:    Fri May 1 08:14:20 PDT 1998
>Last-Modified:  Fri May  1 08:16:14 PDT 1998
>Originator:     Kazuo Horikawa
>Release:        FreeBSD 2.2.5-RELEASE i386
>Organization:
personal user
>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

>Release-Note:
>Audit-Trail:

From: Kazuo Horikawa <k-horik@yk.rim.or.jp>
To: FreeBSD-gnats-submit@FreeBSD.ORG, horikawa@jp.freebsd.org
Cc:  Subject: Re: docs/6454: In tzfile.5, tzfile.h does not exist, and tzh_timecnt is misused.
Date: Fri, 01 May 1998 23:25:07 +0900

 It was my misunderstanding.  So, please cancel (close) this PR.
 
 I found the file src/lib/libc/stdtime/tzfile.h:
 **      tzh_timecnt (char [4])s         coded transition times a la time(2)
 **      tzh_timecnt (unsigned char)s    types of local time starting at above
 **      tzh_typecnt repetitions of
 **              one (char [4])          coded GMT offset in seconds
 **              one (unsigned char)     used to set tm_isdst
 **              one (unsigned char)     that's an abbreviation list index
 and that "Next come tzh_timecnt one-byte values of type unsigned
 char;" is correct.
State-Changed-From-To: open->closed 
State-Changed-By: steve 
State-Changed-When: Fri May 1 08:14:20 PDT 1998 
State-Changed-Why:  
Closed at originator's request. 
>Unformatted:
