summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPaul Eggert <eggert@cs.ucla.edu>2016-04-03 15:27:21 -0700
committerPaul Eggert <eggert@cs.ucla.edu>2016-04-03 15:28:09 -0700
commitc4963f9a905bf15740aa7e3ebf85af917f17be15 (patch)
tree87118897535f8159f47377ed4d6840395832aad1
parent787df9dd053581b7e15fb0cd1ee3e9a17dbd1ad7 (diff)
Fix doc for Universal Time
* doc/lispref/os.texi (Time of Day, Time Conversion): Be more careful about distinguishing UTC (which is not valid for pre-1961 time stamps) and UT (which is). (Time Parsing): Remove stray obsolete paragraph about a UNIVERSAL argument for ‘format-time-string’.
-rw-r--r--doc/lispref/os.texi14
-rw-r--r--etc/NEWS4
2 files changed, 7 insertions, 11 deletions
diff --git a/doc/lispref/os.texi b/doc/lispref/os.texi
index c5e3672a35..8839745268 100644
--- a/doc/lispref/os.texi
+++ b/doc/lispref/os.texi
@@ -1305,7 +1305,7 @@ This function returns a list describing the time zone that the user is
in.
The value has the form @code{(@var{offset} @var{name})}. Here
-@var{offset} is an integer giving the number of seconds ahead of UTC
+@var{offset} is an integer giving the number of seconds ahead of Universal Time
(east of Greenwich). A negative value means west of Greenwich. The
second element, @var{name}, is a string giving the name of the time
zone. Both elements change when daylight saving time begins or ends;
@@ -1323,7 +1323,7 @@ defaults to the current time zone rule.
@vindex TZ, environment variable
The default time zone is determined by the @env{TZ} environment
variable. @xref{System Environment}. For example, you can tell Emacs
-to default to universal time with @code{(setenv "TZ" "UTC0")}. If
+to default to Universal Time with @code{(setenv "TZ" "UTC0")}. If
@env{TZ} is not in the environment, Emacs uses system wall clock time,
which is a platform-dependent default time zone.
@@ -1347,8 +1347,8 @@ calendrical information and vice versa.
Many 32-bit operating systems are limited to system times containing
32 bits of information in their seconds component; these systems
-typically handle only the times from 1901-12-13 20:45:52 UTC through
-2038-01-19 03:14:07 UTC@. However, 64-bit and some 32-bit operating
+typically handle only the times from 1901-12-13 20:45:52 through
+2038-01-19 03:14:07 Universal Time. However, 64-bit and some 32-bit operating
systems have larger seconds components, and can represent times far in
the past or future.
@@ -1390,7 +1390,7 @@ Sunday.
@item dst
@code{t} if daylight saving time is effect, otherwise @code{nil}.
@item utcoff
-An integer indicating the UTC offset in seconds, i.e., the number of
+An integer indicating the Universal Time offset in seconds, i.e., the number of
seconds east of Greenwich.
@end table
@@ -1559,10 +1559,6 @@ based on the Japanese Emperors' reigns. @samp{E} is allowed in
representation of numbers, instead of the ordinary decimal digits. This
is allowed with most letters, all the ones that output numbers.
-If @var{universal} is non-@code{nil}, that means to describe the time as
-Universal Time; @code{nil} means describe it using what Emacs believes
-is the local time zone (see @code{current-time-zone}).
-
This function uses the C library function @code{strftime}
(@pxref{Formatting Calendar Time,,, libc, The GNU C Library Reference
Manual}) to do most of the work. In order to communicate with that
diff --git a/etc/NEWS b/etc/NEWS
index 7de746e755..95265882ec 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1772,8 +1772,8 @@ function 'encode-time', which already accepted a simple time zone rule
argument, has been extended to accept all the new forms.
*** Incompatible change in the third argument of 'format-time-string'.
-Previously, any non-nil argument was interpreted as a UTC time zone.
-This is no longer true; packages that want UTC time zone should pass t
+Previously, any non-nil argument was interpeted as specifying Universal Time.
+This is no longer true; packages that want Universal Time should pass t
as the third argument.
*** Time-related functions now consistently accept numbers