From nobody@FreeBSD.ORG Thu Oct 14 02:54:34 1999
Return-Path: <nobody@FreeBSD.ORG>
Received: by hub.freebsd.org (Postfix, from userid 32767)
	id 0974614CE1; Thu, 14 Oct 1999 02:54:33 -0700 (PDT)
Message-Id: <19991014095433.0974614CE1@hub.freebsd.org>
Date: Thu, 14 Oct 1999 02:54:33 -0700 (PDT)
From: gram@cequrux.com
Sender: nobody@FreeBSD.ORG
To: freebsd-gnats-submit@freebsd.org
Subject: tzfile manual page has omissions and errors
X-Send-Pr-Version: www-1.0

>Number:         14320
>Category:       docs
>Synopsis:       tzfile manual page has omissions and errors
>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:   Thu Oct 14 03:00:01 PDT 1999
>Closed-Date:    Wed Dec 15 06:01:00 PST 1999
>Last-Modified:  Wed Dec 15 06:03:39 PST 1999
>Originator:     Graham Wheeler
>Release:        2.2.8
>Organization:
CEQURUX Technologies
>Environment:
>Description:
The tzfile manual page has some errors and ommisions:

* it refers to a tzfile.h header file which does not appear to exist
* it talks about the first bytes of the timezoen file being reserved
	for future use, but does not specify how many bytes are reserved
* it talks about a tzh_charcnt field, containing the number of bytes
	of timezone abbreviation strings, but does not specify where 
	in the file these abbreviations are stored.


>How-To-Repeat:
man 5 tzfile
>Fix:
Correct the manpage.

>Release-Note:
>Audit-Trail:

From: Graham Wheeler <gram@cequrux.com>
To: freebsd-gnats-submit@freebsd.org, gram@cequrux.com
Cc:  
Subject: Re: docs/14320: tzfile manual page has omissions and errors
Date: Thu, 14 Oct 1999 12:25:14 +0200

 My last objection is wrong; it is possible to work out where the TZ
 abbreviations are stored (but one still need sto know how many reserved
 bytes are at the start).
 
 -- 
 Dr Graham Wheeler                        E-mail: gram@cequrux.com
 Cequrux Technologies                     Phone:  +27(21)423-6065/6/7
 Firewalls/Virtual Private Networks       Fax:    +27(21)24-3656
 Data/Network Security Specialists        WWW:    http://www.cequrux.com/
 
State-Changed-From-To: open->closed 
State-Changed-By: nbm 
State-Changed-When: Wed Dec 15 06:01:00 PST 1999 
State-Changed-Why:  
PR docs/14035 covers the same issues, and has a possible patch to 
deal with them. 
>Unformatted:
