Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 250717 - Timezone setting instructions are incomplete.
Summary: Timezone setting instructions are incomplete.
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs on www.gentoo.org
Classification: Unclassified
Component: Other documents (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: nm (RETIRED)
URL: http://www.gentoo.org/doc/en/guide-lo...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2008-12-12 17:25 UTC by Wilson M. Michaels
Modified: 2009-02-11 09:03 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Wilson M. Michaels 2008-12-12 17:25:12 UTC
Timezone setting instructions are incomplete. /etc/localtime may contain the "Factory" or other wrong setting.

Reproducible: Always




Add something like to following to timezone setting:

You first need to select your timezone so that your system knows where it is located. Look for your timezone in /usr/share/zoneinfo, then copy it to /etc/localtime. Data in /usr/share/zoneinfo and subdirectories is already compiled using zic.

Please avoid the /usr/share/zoneinfo/Etc/GMT* timezones as their names do not indicate the expected zones. For instance, GMT-8 is in fact GMT+8.

Code Listing 1.1: Setting the timezone information

# ls /usr/share/zoneinfo
(Suppose you want to use GMT)
# cp /usr/share/zoneinfo/GMT /etc/localtime
Comment 1 SpanKY gentoo-dev 2008-12-25 23:20:42 UTC
/etc/localtime needs to be done only once and thus is documented in the install guide:
http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=1&chap=8
Comment 2 Wilson M. Michaels 2008-12-29 23:30:33 UTC
I opened this bug because I ran into the problem of /etc/localtime set to "factory" when I upgraded from a rather old version of gentoo. I looked up timezone setting in the "Locale" documentation as that was my problem. It appears to work as KDE's clock shows the correct local time no matter how /etc/localtime is configured. MythTV, on the other hand, has big problems such as the wrong times displayed on the program schedules and the inability to delete recordings.

A person who relocates to a different timezone will also need to set /etc/localtime as part of that relocation. It is not necessary to reinstall Linux just because you change timeszone.

These are two reasons I think that /etc/timezone should also be mentioned in the "Locale" documentation. It is not a setting that is only done during the initial installation of gentoo Linux.
Comment 3 nm (RETIRED) gentoo-dev 2009-02-11 09:03:13 UTC
Fixed in CVS.