This is the mail archive of the libc-alpha@sourceware.org mailing list for the glibc project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

[PATCH][COVER LETTER] manual/time.texi: TZ and zoneinfo updates


Hello Everyone,

This is my first contribution to the glibc manual and I do not
know what level of proof is required for changes, so I'll try
to be brief.

1) the manual says:
"this count includes leap seconds if you set TZ to certain values"

Obviously, setting TZ does not change the System Clock time.
As evidence of what I wrote regarding the configuration for using the
'right' database, I will quote the zoneinfo Makefile:

# In earlier versions of this makefile, the other two directories were
# subdirectories of $(TZDIR).  However, this led to configuration errors.
# For example, with posix_right under the earlier scheme,
# TZ='right/Australia/Adelaide' got you localtime with leap seconds,
# but gmtime without leap seconds, which led to problems with applications
# like sendmail that subtract gmtime from localtime.
# Therefore, the other two directories are now siblings of $(TZDIR).
# You must replace all of $(TZDIR) to switch from not using leap seconds
# to using them, or vice versa.

2) When TZ is set to an invalid value glibc defaults to UTC.

I do not have anything to quote on this one, but that is
indeed what happens.

3) Path to the zoneinfo database has changed to /usr/share/zoneinfo.

The Manual:
C.2 Installing the C Library
============================
For a system wide installation (the given paths are for an installation
with `--prefix=/usr'), link the timezone file which is in
`/usr/share/zoneinfo' to the file `/etc/localtime'.

Makeconfig:
datadir = $(prefix)/share
zonedir = $(datadir)/zoneinfo

4) The zoneinfo data is no longer installed by glibc:

commit 482ff4dae91cf9a288284072d1a299868db7a634
Author: Ulrich Drepper <drepper@gmail.com>
Date:   Wed Mar 7 04:48:47 2012 -0500

    Don't install timezone rule files


J William Piggott (1):
  manual/time.texi: TZ and zoneinfo updates

 manual/time.texi | 22 +++++++++++++++-------
 1 file changed, 15 insertions(+), 7 deletions(-)


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]