#61011 manpage/info-file for 'date' should explain difference between hardware clock and system clock

Package:
src:coreutils
Source:
coreutils
Submitter:
Date:
2010-10-05 14:51:03 UTC
Severity:
wishlist
#61011#5
Date:
2000-03-23 16:34:23 UTC
From:
To:
If you are not familiar with the fact that Linux on i386 has *two* clocks
(the system clock maintained by the kernel and the hardware clock in a
chip on your motherboard), the documentation for the 'date' command is
somewhat confusing. The term 'system clock' is used throughout these
documents, but without explaining what it refers to.

IMHO it would therefore be a good idea to include a short remark
explaining what is meant by 'system clock'.

Maybe you could insert something like the following:
(just a proposal)
into the manpage date (1)

old:
DESCRIPTION
       Display  the  current time in the given FORMAT, or set the
       system date.
new:
DESCRIPTION
       Display  the  current time in the given FORMAT, or set the
       system date as maintained by the kernel. This command does not
       affect the hardware clock  (or 'bios' clock); use the hwclock
       command for doing that.

and add under 'SEE ALSO':
SEE ALSO
      [...]
       hwclock (8)  for manipulating the hardware ('bios') clock

and equivalent changes in the info pages.