aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorPaul Eggert2016-04-03 15:27:21 -0700
committerPaul Eggert2016-04-03 15:28:09 -0700
commitc4963f9a905bf15740aa7e3ebf85af917f17be15 (patch)
tree87118897535f8159f47377ed4d6840395832aad1
parent787df9dd053581b7e15fb0cd1ee3e9a17dbd1ad7 (diff)
downloademacs-c4963f9a905bf15740aa7e3ebf85af917f17be15.tar.gz
emacs-c4963f9a905bf15740aa7e3ebf85af917f17be15.zip
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 c5e3672a35a..88397452689 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
1305in. 1305in.
1306 1306
1307The value has the form @code{(@var{offset} @var{name})}. Here 1307The value has the form @code{(@var{offset} @var{name})}. Here
1308@var{offset} is an integer giving the number of seconds ahead of UTC 1308@var{offset} is an integer giving the number of seconds ahead of Universal Time
1309(east of Greenwich). A negative value means west of Greenwich. The 1309(east of Greenwich). A negative value means west of Greenwich. The
1310second element, @var{name}, is a string giving the name of the time 1310second element, @var{name}, is a string giving the name of the time
1311zone. Both elements change when daylight saving time begins or ends; 1311zone. Both elements change when daylight saving time begins or ends;
@@ -1323,7 +1323,7 @@ defaults to the current time zone rule.
1323@vindex TZ, environment variable 1323@vindex TZ, environment variable
1324The default time zone is determined by the @env{TZ} environment 1324The default time zone is determined by the @env{TZ} environment
1325variable. @xref{System Environment}. For example, you can tell Emacs 1325variable. @xref{System Environment}. For example, you can tell Emacs
1326to default to universal time with @code{(setenv "TZ" "UTC0")}. If 1326to default to Universal Time with @code{(setenv "TZ" "UTC0")}. If
1327@env{TZ} is not in the environment, Emacs uses system wall clock time, 1327@env{TZ} is not in the environment, Emacs uses system wall clock time,
1328which is a platform-dependent default time zone. 1328which is a platform-dependent default time zone.
1329 1329
@@ -1347,8 +1347,8 @@ calendrical information and vice versa.
1347 1347
1348 Many 32-bit operating systems are limited to system times containing 1348 Many 32-bit operating systems are limited to system times containing
134932 bits of information in their seconds component; these systems 134932 bits of information in their seconds component; these systems
1350typically handle only the times from 1901-12-13 20:45:52 UTC through 1350typically handle only the times from 1901-12-13 20:45:52 through
13512038-01-19 03:14:07 UTC@. However, 64-bit and some 32-bit operating 13512038-01-19 03:14:07 Universal Time. However, 64-bit and some 32-bit operating
1352systems have larger seconds components, and can represent times far in 1352systems have larger seconds components, and can represent times far in
1353the past or future. 1353the past or future.
1354 1354
@@ -1390,7 +1390,7 @@ Sunday.
1390@item dst 1390@item dst
1391@code{t} if daylight saving time is effect, otherwise @code{nil}. 1391@code{t} if daylight saving time is effect, otherwise @code{nil}.
1392@item utcoff 1392@item utcoff
1393An integer indicating the UTC offset in seconds, i.e., the number of 1393An integer indicating the Universal Time offset in seconds, i.e., the number of
1394seconds east of Greenwich. 1394seconds east of Greenwich.
1395@end table 1395@end table
1396 1396
@@ -1559,10 +1559,6 @@ based on the Japanese Emperors' reigns. @samp{E} is allowed in
1559representation of numbers, instead of the ordinary decimal digits. This 1559representation of numbers, instead of the ordinary decimal digits. This
1560is allowed with most letters, all the ones that output numbers. 1560is allowed with most letters, all the ones that output numbers.
1561 1561
1562If @var{universal} is non-@code{nil}, that means to describe the time as
1563Universal Time; @code{nil} means describe it using what Emacs believes
1564is the local time zone (see @code{current-time-zone}).
1565
1566This function uses the C library function @code{strftime} 1562This function uses the C library function @code{strftime}
1567(@pxref{Formatting Calendar Time,,, libc, The GNU C Library Reference 1563(@pxref{Formatting Calendar Time,,, libc, The GNU C Library Reference
1568Manual}) to do most of the work. In order to communicate with that 1564Manual}) to do most of the work. In order to communicate with that
diff --git a/etc/NEWS b/etc/NEWS
index 7de746e7556..95265882ec3 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1772,8 +1772,8 @@ function 'encode-time', which already accepted a simple time zone rule
1772argument, has been extended to accept all the new forms. 1772argument, has been extended to accept all the new forms.
1773 1773
1774*** Incompatible change in the third argument of 'format-time-string'. 1774*** Incompatible change in the third argument of 'format-time-string'.
1775Previously, any non-nil argument was interpreted as a UTC time zone. 1775Previously, any non-nil argument was interpeted as specifying Universal Time.
1776This is no longer true; packages that want UTC time zone should pass t 1776This is no longer true; packages that want Universal Time should pass t
1777as the third argument. 1777as the third argument.
1778 1778
1779*** Time-related functions now consistently accept numbers 1779*** Time-related functions now consistently accept numbers