tzset.3: Filespec omitted incorrect

Paragraph three of the DESCRIPTION section says
that when TZ is set, but empty, then UTC is used.

Later it says if the TZ filespec is omitted then the file
/usr/share/zoneinfo/localtime is used.  This is incorrect,
it will use UTC in that case as well.

Steps to reproduce:

cd /usr/share/zoneinfo/
cp Antarctica/South_Pole localtime
cd
date
Sun Jan 18 10:59:50 EST 2015
TZ=:Hongkong date
Sun Jan 18 23:59:56 HKT 2015
TZ=:/usr/share/zoneinfo/localtime date
Mon Jan 19 05:00:03 NZDT 2015
TZ=: date
Sun Jan 18 16:00:11 UTC 2015
TZ=":" date
Sun Jan 18 16:00:18 UTC 2015
TZ=':' date
Sun Jan 18 16:00:24 UTC 2015
TZ=:/ date
Sun Jan 18 16:00:34  2015
TZ=":/" date
Sun Jan 18 16:00:40  2015
TZ="" date
Sun Jan 18 16:00:45 UTC 2015

Signed-off-by: J William Piggott <elseifthen@gmx.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
JWP 2015-01-18 15:00:07 -05:00 committed by Michael Kerrisk
parent 46e306fddc
commit 4e00a0b860
1 changed files with 2 additions and 8 deletions

View File

@ -170,14 +170,8 @@ from a file:
:[filespec]
.RE
.sp
If the file specification \fIfilespec\fP is omitted, the timezone
information is read from the file
.I localtime
in the system timezone directory, which nowadays usually is
.IR /usr/share/zoneinfo .
This file is in
.BR tzfile (5)
format.
If the file specification \fIfilespec\fP is omitted, or its value cannot
be interpreted, then Coordinated Universal Time (UTC) is used.
If \fIfilespec\fP is given, it specifies another
.BR tzfile (5)-format
file to read the timezone information from.