Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 122800 - Docs show date format different from real install
Summary: Docs show date format different from real install
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs on www.gentoo.org
Classification: Unclassified
Component: Installation Handbook (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Xavier Neys (RETIRED)
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2006-02-14 08:04 UTC by Timothy Miller
Modified: 2006-05-27 05:48 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 Timothy Miller 2006-02-14 08:04:12 UTC
The install docs (http://www.gentoo.org/doc/en/handbook/2005.1/handbook-amd64.xml?part=1&chap=5) talk about setting the date.  The docs talk show a timezone, while in the real 2005.1 I get UTC.  There's no mention of how to set the timezone or anything like that.  If the date is consistently in UTC, please change the docs.  Otherwise, please explain how to deal with variations in what the user sees.
Comment 1 Timothy Miller 2006-02-14 08:05:33 UTC
Also, it makes me nervous that there is a warning about incorrect dates causing problems, but there's no mention of whether or not date comparisons will work correctly if dates are in UTC format.
Comment 2 nm (RETIRED) gentoo-dev 2006-02-14 08:12:51 UTC
> The install docs
> (http://www.gentoo.org/doc/en/handbook/2005.1/handbook-amd64.xml?part=1&chap=5)
> talk about setting the date.  The docs talk show a timezone, while in the real
> 2005.1 I get UTC.  There's no mention of how to set the timezone or anything
> like that.  If the date is consistently in UTC, please change the docs. 
> Otherwise, please explain how to deal with variations in what the user sees.

Keep in mind that the time displayed what your actual hardware clock is set to. In my case, it's actually PST, since that's my local timezone

Later in the install process, you are given a choice to set your hardware clock according to UTC or localtime; please see http://www.gentoo.org/doc/en/handbook/2005.1/handbook-amd64.xml?part=1&chap=8#doc_chap3 for specifying UTC or local.

***

Docs-team: whatever happened to the instructions about setting timezones when setting date? For example:

# rm /etc/localtime/
# ln -sf /usr/share/zoneinfo/<country>/<city> /etc/localtime

Might be a good place to include that.
Comment 3 SpanKY gentoo-dev 2006-02-14 10:05:27 UTC
the date needs to be set before anything is unpacked/installed/whatever ... you cant install the gentoo base system and then set the clock

as for actually setting it, you set the clock to the localtime
Comment 4 Timothy Miller 2006-02-14 10:27:08 UTC
When you say to set the date to local time, do you mean that I should ignore the fact that it says UTC and set it to the local time anyhow?  Later, when I set a timezone, won't it misinterpret that and decide that the clock (which is in UTC) needs to have an offset added whenever it's displayed?
Comment 5 Shyam Mani (RETIRED) gentoo-dev 2006-02-17 09:22:47 UTC
(In reply to comment #4)

> When you say to set the date to local time, do you mean that I should ignore
> the fact that it says UTC and set it to the local time anyhow?  Later, when I
> set a timezone, won't it misinterpret that and decide that the clock (which is
> in UTC) needs to have an offset added whenever it's displayed?

As far as my installs go, I tend to make sure the *time* itself is correct and I ignore the *timezone* until I set it up by copying the timezone into /etc/localtime.
 
Comment 6 Xavier Neys (RETIRED) gentoo-dev 2006-03-14 07:26:27 UTC
(In reply to comment #2)
> Docs-team: whatever happened to the instructions about setting timezones when
> setting date? For example:
> 
> # rm /etc/localtime/
> # ln -sf /usr/share/zoneinfo/<country>/<city> /etc/localtime

Haven't been moved, still in &chap=7

(In reply to comment #5)
> As far as my installs go, I tend to make sure the *time* itself is correct and
> I ignore the *timezone* until I set it up by copying the timezone into
> /etc/localtime.

which is wrong. If you use localtime instead of UTC in the LiveCD environment, your time will jump when you define your timezone later.

Besides, Timothy is right, the output of `date` shows UTC time, not CEST.
Better use UTC if you need to set the time IMO.
Comment 7 Xavier Neys (RETIRED) gentoo-dev 2006-05-27 05:48:55 UTC
Fixed. Thanks for reporting.