Do not reference tzfile.h since that is an internal header.

Be clear that "standard" byte order means big endian.
Update struct ttinfo.

1 files changed, 12 insertions, 12 deletions

diff --git a/lib/libc/time/tzfile.5 b/lib/libc/time/tzfile.5
index ce71b9a070b..48679f8ddfc 100644
--- a/lib/libc/time/tzfile.5
+++ b/lib/libc/time/tzfile.5
@@ -1,12 +1,10 @@
-.\"	$OpenBSD: tzfile.5,v 1.14 2012/09/13 11:14:20 millert Exp $
-.Dd $Mdocdate: September 13 2012 $
+.\"	$OpenBSD: tzfile.5,v 1.15 2015/03/14 22:15:09 millert Exp $
+.Dd $Mdocdate: March 14 2015 $
 .Dt TZFILE 5
 .Os
 .Sh NAME
 .Nm tzfile
 .Nd time zone information
-.Sh SYNOPSIS
-.Fd #include <tzfile.h>
 .Sh DESCRIPTION
 The time zone information files used by
 .Xr tzset 3
@@ -16,12 +14,12 @@ followed by a character identifying the version of the file's format
 (as of 2005, either an ASCII NUL or a '2')
 followed by fifteen bytes containing zeroes reserved for future use,
 followed by six four-byte values of type
-.Fa long
+.Fa int
 written in a
-.Dq standard
+.Dq big endian
 byte order
 .Po
-the high-order byte of the value is written first
+the most significant byte of the value is written first
 .Pc .
 These values are,
 in order:
@@ -71,9 +69,9 @@ these structures are defined as follows:
 .Bd -literal -offset indent
 .ta .5i +\w'unsigned int\0\0'u
 struct ttinfo {
-	long	tt_gmtoff;
-	int	tt_isdst;
-	unsigned int	tt_abbrind;
+	long	tt_gmtoff;	/* UTC offset in seconds */
+	int	tt_isdst;	/* used to set tm_isdst */
+	int	tt_abbrind;	/* abbreviation list index */
 };
 .Ed
 .Pp
@@ -81,7 +79,9 @@ Each structure is written as a four-byte value for
 .Fa tt_gmtoff
 of type
 .Fa long ,
-in a standard byte order, followed by a one-byte value for
+in
+.Dq big endian
+byte order, followed by a one-byte value for
 .Fa tt_isdst
 and a one-byte value for
 .Fa tt_abbrind .
@@ -140,7 +140,7 @@ is zero or the time argument is less than the first transition time recorded
 in the file.
 .Pp
 For version-2-format time zone files,
-the above header and data is followed by a second header and data,
+the above header and data are followed by a second header and data,
 identical in format except that
 eight bytes are used for each transition time or leap second time.
 After the second header and data comes a newline-enclosed,