[Emacs-diffs] /srv/bzr/emacs/trunk r105422: Fix explanation about setting the time zone in Lisp manual.

[Chong Yidong]

------------------------------------------------------------
revno: 105422
committer: Chong Yidong <address@hidden>
branch nick: trunk
timestamp: Mon 2011-08-08 12:06:34 -0400
message:
  Fix explanation about setting the time zone in Lisp manual.
  
  * doc/lispref/os.texi (Time of Day): Remove set-time-zone-rule, and
  recommend using setenv instead.
modified:
  doc/lispref/ChangeLog
  doc/lispref/os.texi

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2011-07-28 17:18:25 +0000
+++ b/doc/lispref/ChangeLog     2011-08-08 16:06:34 +0000
@@ -1,3 +1,8 @@
+2011-08-08  Chong Yidong  <address@hidden>
+
+       * os.texi (Time of Day): Remove set-time-zone-rule, and recommend
+       using setenv instead.
+
 2011-07-28  Eli Zaretskii  <address@hidden>
 
        * display.texi (Bidirectional Display): Document the fact that

=== modified file 'doc/lispref/os.texi'
--- a/doc/lispref/os.texi       2011-06-03 18:49:33 +0000
+++ b/doc/lispref/os.texi       2011-08-08 16:06:34 +0000
@@ -1143,6 +1143,18 @@
 @xref{Definition of file-attributes}.
 @end defun
 
address@hidden float-time &optional time-value
+This function returns the current time as a floating-point number of
+seconds since the epoch.  The argument @var{time-value}, if given,
+specifies a time to convert instead of the current time.  The argument
+should have the same form as for @code{current-time-string} (see
+above).  Thus, it accepts the output of @code{current-time} and
address@hidden (@pxref{Definition of file-attributes}).
+
address@hidden: Since the result is floating point, it may not be
+exact.  Do not use this function if precise time stamps are required.
address@hidden defun
+
 @defun current-time-zone &optional time-value
 This function returns a list describing the time zone that the user is
 in.
@@ -1165,25 +1177,11 @@
 @code{file-attributes}.  @xref{Definition of file-attributes}.
 @end defun
 
address@hidden set-time-zone-rule tz
-This function specifies the local time zone according to @var{tz}.  If
address@hidden is @code{nil}, that means to use an implementation-defined
-default time zone.  If @var{tz} is @code{t}, that means to use
-Universal Time.  Otherwise, @var{tz} should be a string specifying a
-time zone rule.
address@hidden defun
-
address@hidden float-time &optional time-value
-This function returns the current time as a floating-point number of
-seconds since the epoch.  The argument @var{time-value}, if given,
-specifies a time to convert instead of the current time.  The argument
-should have the same form as for @code{current-time-string} (see
-above).  Thus, it accepts the output of @code{current-time} and
address@hidden (@pxref{Definition of file-attributes}).
-
address@hidden: Since the result is floating point, it may not be
-exact.  Do not use this function if precise time stamps are required.
address@hidden defun
+The current time zone is determined by the @samp{TZ} environment
+variable.  @xref{System Environment}.  For example, you can tell Emacs
+to use universal time with @code{(setenv "TZ" "UTC0")}.  If @samp{TZ}
+is not in the environment, Emacs uses a platform-dependent default
+time zone.
 
 @node Time Conversion
 @section Time Conversion