Bug 14320

Summary: tzfile manual page has omissions and errors
Product: Documentation Reporter: gram <gram>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description gram 1999-10-14 11:00:01 UTC
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.

Fix: 

Correct the manpage.
How-To-Repeat: man 5 tzfile
Comment 1 gram 1999-10-14 11:25:14 UTC
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/
Comment 2 nbm freebsd_committer freebsd_triage 1999-12-15 14:01:00 UTC
State Changed
From-To: open->closed

PR docs/14035 covers the same issues, and has a possible patch to 
deal with them.