[Emacs-diffs] Changes to emacs/lispref/os.texi [lexbind]

[Miles Bader]

Index: emacs/lispref/os.texi
diff -c emacs/lispref/os.texi:1.48.2.1 emacs/lispref/os.texi:1.48.2.2
*** emacs/lispref/os.texi:1.48.2.1      Fri Apr  4 01:20:42 2003
--- emacs/lispref/os.texi       Tue Oct 14 19:10:12 2003
***************
*** 216,222 ****
  Emacs.
  @end defvar
  
!   @xref{Init File Examples,,, emacs, The GNU Emacs Manual}, for
  examples of how to make various commonly desired customizations in your
  @file{.emacs} file.
  
--- 216,222 ----
  Emacs.
  @end defvar
  
!   @xref{Init Examples,, Init File Examples, emacs, The GNU Emacs Manual}, for
  examples of how to make various commonly desired customizations in your
  @file{.emacs} file.
  
***************
*** 400,407 ****
  
  The command-line arguments are parsed by the @code{command-line-1}
  function in the @file{startup.el} file.  See also @ref{Command
! Switches, , Command Line Switches and Arguments, emacs, The GNU Emacs
! Manual}.
  @end defvar
  
  @defvar command-line-args
--- 400,406 ----
  
  The command-line arguments are parsed by the @code{command-line-1}
  function in the @file{startup.el} file.  See also @ref{Command
! Arguments, , Command Line Arguments, emacs, The GNU Emacs Manual}.
  @end defvar
  
  @defvar command-line-args
***************
*** 797,802 ****
--- 796,806 ----
  If @var{use-float} is address@hidden, then they are returned
  as floating point numbers and without multiplying by 100.
  
+ If it is impossible to obtain the load average, this function signals
+ an error.  On some platforms, access to load averages requires
+ installing Emacs as setuid or setgid so that it can read kernel
+ information, and that usually isn't advisable.
+ 
  @example
  @group
  (load-average)
***************
*** 918,923 ****
--- 922,928 ----
  
  @defun user-real-uid
  This function returns the real @sc{uid} of the user.
+ The value may be a floating point number.
  
  @example
  @group
***************
*** 929,934 ****
--- 934,940 ----
  
  @defun user-uid
  This function returns the effective @sc{uid} of the user.
+ The value may be a floating point number.
  @end defun
  
  @node Time of Day
***************
*** 1162,1170 ****
  the inverse conversion, use @code{float-time}.
  @end defun
  
! @defun decode-time time
! This function converts a time value into calendrical information.  The
! return value is a list of nine elements, as follows:
  
  @example
  (@var{seconds} @var{minutes} @var{hour} @var{day} @var{month} @var{year} 
@var{dow} @var{dst} @var{zone})
--- 1168,1177 ----
  the inverse conversion, use @code{float-time}.
  @end defun
  
! @defun decode-time &optional time
! This function converts a time value into calendrical information.  If
! you don't specify @var{time}, it decodes the current time.  The return
! value is a list of nine elements, as follows:
  
  @example
  (@var{seconds} @var{minutes} @var{hour} @var{day} @var{month} @var{year} 
@var{dow} @var{dst} @var{zone})
***************
*** 1231,1236 ****
--- 1238,1245 ----
  
  The operating system puts limits on the range of possible time values;
  if you try to encode a time that is out of range, an error results.
+ For instance, years before 1970 do not work on some systems;
+ on others, years as early as 1901 do work.
  @end defun
  
  @node Time Calculations
***************
*** 1276,1283 ****
  @section Timers for Delayed Execution
  @cindex timer
  
!   You can set up a @dfn{timer} to call a function at a specified future time 
or
! after a certain length of idleness.
  
    Emacs cannot run timers at any arbitrary point in a Lisp program; it
  can run them only when Emacs could accept output from a subprocess:
--- 1285,1292 ----
  @section Timers for Delayed Execution
  @cindex timer
  
!   You can set up a @dfn{timer} to call a function at a specified
! future time or after a certain length of idleness.
  
    Emacs cannot run timers at any arbitrary point in a Lisp program; it
  can run them only when Emacs could accept output from a subprocess:
***************
*** 1286,1291 ****
--- 1295,1307 ----
  timer's execution may be delayed if Emacs is busy.  However, the time of
  execution is very precise if Emacs is idle.
  
+   Emacs binds @code{inhibit-quit} to @code{t} before calling the timer
+ function, because quitting out of many timer functions can leave
+ things in an inconsistent state.  This is normally unproblematical
+ because most timer functions don't do a lot of work.  Indeed, for a
+ timer to calls a function that takes substantial time to run is likely
+ to be annoying.
+ 
  @defun run-at-time time repeat function &rest args
  This function arranges to call @var{function} with arguments @var{args}
  at time @var{time}.  The argument @var{function} is a function to call
***************
*** 2064,2066 ****
--- 2080,2086 ----
    nil)
  @end group
  @end example
+ 
+ @ignore
+    arch-tag: 8378814a-30d7-467c-9615-74a80b9988a7
+ @end ignore