diff options
| author | Paul Eggert | 2016-04-03 15:27:21 -0700 |
|---|---|---|
| committer | Paul Eggert | 2016-04-03 15:28:09 -0700 |
| commit | c4963f9a905bf15740aa7e3ebf85af917f17be15 (patch) | |
| tree | 87118897535f8159f47377ed4d6840395832aad1 | |
| parent | 787df9dd053581b7e15fb0cd1ee3e9a17dbd1ad7 (diff) | |
| download | emacs-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.texi | 14 | ||||
| -rw-r--r-- | etc/NEWS | 4 |
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 | |||
| 1305 | in. | 1305 | in. |
| 1306 | 1306 | ||
| 1307 | The value has the form @code{(@var{offset} @var{name})}. Here | 1307 | The 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 |
| 1310 | second element, @var{name}, is a string giving the name of the time | 1310 | second element, @var{name}, is a string giving the name of the time |
| 1311 | zone. Both elements change when daylight saving time begins or ends; | 1311 | zone. 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 |
| 1324 | The default time zone is determined by the @env{TZ} environment | 1324 | The default time zone is determined by the @env{TZ} environment |
| 1325 | variable. @xref{System Environment}. For example, you can tell Emacs | 1325 | variable. @xref{System Environment}. For example, you can tell Emacs |
| 1326 | to default to universal time with @code{(setenv "TZ" "UTC0")}. If | 1326 | to 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, |
| 1328 | which is a platform-dependent default time zone. | 1328 | which 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 |
| 1349 | 32 bits of information in their seconds component; these systems | 1349 | 32 bits of information in their seconds component; these systems |
| 1350 | typically handle only the times from 1901-12-13 20:45:52 UTC through | 1350 | typically handle only the times from 1901-12-13 20:45:52 through |
| 1351 | 2038-01-19 03:14:07 UTC@. However, 64-bit and some 32-bit operating | 1351 | 2038-01-19 03:14:07 Universal Time. However, 64-bit and some 32-bit operating |
| 1352 | systems have larger seconds components, and can represent times far in | 1352 | systems have larger seconds components, and can represent times far in |
| 1353 | the past or future. | 1353 | the 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 |
| 1393 | An integer indicating the UTC offset in seconds, i.e., the number of | 1393 | An integer indicating the Universal Time offset in seconds, i.e., the number of |
| 1394 | seconds east of Greenwich. | 1394 | seconds 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 | |||
| 1559 | representation of numbers, instead of the ordinary decimal digits. This | 1559 | representation of numbers, instead of the ordinary decimal digits. This |
| 1560 | is allowed with most letters, all the ones that output numbers. | 1560 | is allowed with most letters, all the ones that output numbers. |
| 1561 | 1561 | ||
| 1562 | If @var{universal} is non-@code{nil}, that means to describe the time as | ||
| 1563 | Universal Time; @code{nil} means describe it using what Emacs believes | ||
| 1564 | is the local time zone (see @code{current-time-zone}). | ||
| 1565 | |||
| 1566 | This function uses the C library function @code{strftime} | 1562 | This 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 |
| 1568 | Manual}) to do most of the work. In order to communicate with that | 1564 | Manual}) to do most of the work. In order to communicate with that |
| @@ -1772,8 +1772,8 @@ function 'encode-time', which already accepted a simple time zone rule | |||
| 1772 | argument, has been extended to accept all the new forms. | 1772 | argument, 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'. |
| 1775 | Previously, any non-nil argument was interpreted as a UTC time zone. | 1775 | Previously, any non-nil argument was interpeted as specifying Universal Time. |
| 1776 | This is no longer true; packages that want UTC time zone should pass t | 1776 | This is no longer true; packages that want Universal Time should pass t |
| 1777 | as the third argument. | 1777 | as the third argument. |
| 1778 | 1778 | ||
| 1779 | *** Time-related functions now consistently accept numbers | 1779 | *** Time-related functions now consistently accept numbers |