tzset.3: Add ENVIRONMENT section + other rearrangements

FILES section was overly verbose and included
environment variables.  Added ENVIRONMENT section,
removing ENV VARS from the FILES section.

As stated in commit 2c7f200, /usr/share/zoneinfo/localtime
is not used, nor recommended by glibc.

Signed-off-by: J William Piggott <elseifthen@gmx.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
J William Piggott 2015-01-29 11:27:07 -05:00 committed by Michael Kerrisk
parent 0646abd614
commit c1e90e15d3
1 changed files with 20 additions and 21 deletions

View File

@ -182,28 +182,27 @@ Here's an example, once more for New Zealand:
TZ=":Pacific/Auckland"
.fi
.SH ENVIRONMENT
.TP
.B TZ
If this variable is set its value takes precedence over the system
configured timezone.
.TP
.B TZDIR
If this variable is set its value takes precedence over the system
configured timezone database directory path.
.SH FILES
Under glibc,
the system timezone directory is determined using the
.BR TZDIR
the environment variable.
If
.BR TZDIR
is not set, the default depends on the system setup, but is normally
.IR /usr/share/zoneinfo .
.LP
This timezone directory contains the files
.nf
localtime local timezone file
posixrules rules for POSIX-style TZ's
.fi
.LP
Often,
.I /etc/localtime
is a symbolic link to the file
.I localtime
or to the correct timezone file in the system timezone directory.
.TP
.B /etc/localtime
The system timezone file.
.TP
.B /usr/share/zoneinfo/
The system timezone database directory.
.TP
.B /usr/share/zoneinfo/posixrules
.PP
Above are the current standard file locations, but they are
configurable when glibc is compiled.
.SH CONFORMING TO
SVr4, POSIX.1-2001, 4.3BSD.
.SH NOTES