masscollaborationlabs/emacs
2
0
Fork 0
mirror of https://github.com/masscollaborationlabs/emacs.git synced 2025-07-06 20:29:36 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Fix doc for Universal Time

Browse source 
* 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’.
This commit is contained in:
Paul Eggert 2016-04-03 15:27:21 -07:00
parent 787df9dd05
commit c4963f9a90
2 changed files with 7 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

14
doc/lispref/os.texi
View file

@ -1305,7 +1305,7 @@ This function returns a list describing the time zone that the user is
in. in.
The value has the form @code{(@var{offset} @var{name})}. Here 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 (east of Greenwich). A negative value means west of Greenwich. The
second element, @var{name}, is a string giving the name of the time second element, @var{name}, is a string giving the name of the time
zone. Both elements change when daylight saving time begins or ends; 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 @vindex TZ, environment variable
The default time zone is determined by the @env{TZ} environment The default time zone is determined by the @env{TZ} environment
variable. @xref{System Environment}. For example, you can tell Emacs 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, @env{TZ} is not in the environment, Emacs uses system wall clock time,
which is a platform-dependent default time zone. 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 Many 32-bit operating systems are limited to system times containing
32 bits of information in their seconds component; these systems 32 bits of information in their seconds component; these systems
typically handle only the times from 1901-12-13 20:45:52 UTC through typically handle only the times from 1901-12-13 20:45:52 through
2038-01-19 03:14:07 UTC@. However, 64-bit and some 32-bit operating 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 systems have larger seconds components, and can represent times far in
the past or future. the past or future.
@ -1390,7 +1390,7 @@ Sunday.
@item dst @item dst
@code{t} if daylight saving time is effect, otherwise @code{nil}. @code{t} if daylight saving time is effect, otherwise @code{nil}.
@item utcoff @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. seconds east of Greenwich.
@end table @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 representation of numbers, instead of the ordinary decimal digits. This
is allowed with most letters, all the ones that output numbers. 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} This function uses the C library function @code{strftime}
(@pxref{Formatting Calendar Time,,, libc, The GNU C Library Reference (@pxref{Formatting Calendar Time,,, libc, The GNU C Library Reference
Manual}) to do most of the work. In order to communicate with that Manual}) to do most of the work. In order to communicate with that

4
etc/NEWS
View file

@ -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. argument, has been extended to accept all the new forms.
*** Incompatible change in the third argument of 'format-time-string'. *** Incompatible change in the third argument of 'format-time-string'.
Previously, any non-nil argument was interpreted as a UTC time zone. Previously, any non-nil argument was interpeted as specifying Universal Time.
This is no longer true; packages that want UTC time zone should pass t This is no longer true; packages that want Universal Time should pass t
as the third argument. as the third argument.
*** Time-related functions now consistently accept numbers *** Time-related functions now consistently accept numbers