doc: date: mention that the hardware clock might not be set
authorPádraig Brady <P@draigBrady.com>
Tue, 1 Nov 2011 17:29:53 +0000 (17:29 +0000)
committerPádraig Brady <P@draigBrady.com>
Tue, 1 Nov 2011 22:02:55 +0000 (22:02 +0000)
* doc/coreutils.texi (Setting the time): Reorganize slightly
and mention that the hardware clock might need to be explicitly
updated by the user as is the case on Fedora 16 currently.
See http://bugzilla.redhat.com/749516

doc/coreutils.texi

index 9233194..424a431 100644 (file)
@@ -14188,11 +14188,9 @@ is available, it is ignored.
 If given an argument that does not start with @samp{+}, @command{date} sets
 the system clock to the date and time specified by that argument (as
 described below).  You must have appropriate privileges to set the
-system clock.  The @option{--date} and @option{--set} options may not be
-used with such an argument.  The @option{--universal} option may be used
-with such an argument to indicate that the specified date and time are
-relative to Coordinated Universal Time rather than to the local time
-zone.
+system clock.  Note for changes to persist across a reboot, the
+hardware clock may need to be updated from the system clock, which
+might not happen automatically on your system.
 
 The argument must consist entirely of digits, which have the following
 meaning:
@@ -14214,7 +14212,10 @@ last two digits of year (optional)
 second (optional)
 @end table
 
-The @option{--set} option also sets the system clock; see the next section.
+Note, the @option{--date} and @option{--set} options may not be used with an
+argument in the above format.  The @option{--universal} option may be used
+with such an argument to indicate that the specified date and time are
+relative to Coordinated Universal Time rather than to the local time zone.
 
 
 @node Options for date
@@ -14355,6 +14356,7 @@ This is equivalent to the format @samp{%Y-%m-%d %H:%M:%S.%N%:z}.
 @opindex -s
 @opindex --set
 Set the date and time to @var{datestr}.  See @option{-d} above.
+See also @ref{Setting the time}.
 
 @item -u
 @itemx --utc