]> code.delx.au - gnu-emacs/blobdiff - lispref/numbers.texi
(quail-help): The output message is improved.
[gnu-emacs] / lispref / numbers.texi
index fbbdc83871e0427f03879d6ac66062596aba0bd1..eaa2250a3fd101f3c1807fda75284ab467c7ad6e 100644 (file)
@@ -1,6 +1,7 @@
 @c -*-texinfo-*-
 @c This is part of the GNU Emacs Lisp Reference Manual.
-@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998 Free Software Foundation, Inc. 
+@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999
+@c   Free Software Foundation, Inc. 
 @c See the file elisp.texi for copying conditions.
 @setfilename ../info/numbers
 @node Numbers, Strings and Characters, Lisp Data Types, Top
@@ -36,18 +37,18 @@ exact; they have a fixed, limited amount of precision.
 
   The range of values for an integer depends on the machine.  The
 minimum range is @minus{}134217728 to 134217727 (28 bits; i.e.,
-@ifinfo 
+@ifnottex
 -2**27
-@end ifinfo
+@end ifnottex
 @tex 
-$-2^{27}$
+@math{-2^{27}}
 @end tex
 to 
-@ifinfo 
+@ifnottex
 2**27 - 1),
-@end ifinfo
+@end ifnottex
 @tex 
-$2^{27}-1$),
+@math{2^{27}-1}),
 @end tex
 but some machines may provide a wider range.  Many examples in this
 chapter assume an integer has 28 bits.
@@ -312,6 +313,8 @@ otherwise.
 
 @defun max number-or-marker &rest numbers-or-markers
 This function returns the largest of its arguments.
+If any of the argument is floating-point, the value is returned
+as floating point, even if it was given as an integer.
 
 @example
 (max 20)
@@ -319,12 +322,14 @@ This function returns the largest of its arguments.
 (max 1 2.5)
      @result{} 2.5
 (max 1 3 2.5)
-     @result{} 3
+     @result{} 3.0
 @end example
 @end defun
 
 @defun min number-or-marker &rest numbers-or-markers
 This function returns the smallest of its arguments.
+If any of the argument is floating-point, the value is returned
+as floating point, even if it was given as an integer.
 
 @example
 (min -4 1)
@@ -953,37 +958,69 @@ in radians.
 @end defun
 
 @defun asin arg
-The value of @code{(asin @var{arg})} is a number between @minus{}pi/2
-and pi/2 (inclusive) whose sine is @var{arg}; if, however, @var{arg}
+The value of @code{(asin @var{arg})} is a number between
+@ifnottex
+@minus{}pi/2
+@end ifnottex
+@tex
+@math{-\pi/2}
+@end tex
+and
+@ifnottex
+pi/2
+@end ifnottex
+@tex
+@math{\pi/2}
+@end tex
+(inclusive) whose sine is @var{arg}; if, however, @var{arg}
 is out of range (outside [-1, 1]), then the result is a NaN.
 @end defun
 
 @defun acos arg
-The value of @code{(acos @var{arg})} is a number between 0 and pi
+The value of @code{(acos @var{arg})} is a number between 0 and
+@ifnottex
+pi
+@end ifnottex
+@tex
+@math{\pi}
+@end tex
 (inclusive) whose cosine is @var{arg}; if, however, @var{arg}
 is out of range (outside [-1, 1]), then the result is a NaN.
 @end defun
 
 @defun atan arg
-The value of @code{(atan @var{arg})} is a number between @minus{}pi/2
-and pi/2 (exclusive) whose tangent is @var{arg}.
+The value of @code{(atan @var{arg})} is a number between
+@ifnottex
+@minus{}pi/2
+@end ifnottex
+@tex
+@math{-\pi/2}
+@end tex
+and
+@ifnottex
+pi/2
+@end ifnottex
+@tex
+@math{\pi/2}
+@end tex
+(exclusive) whose tangent is @var{arg}.
 @end defun
 
 @defun exp arg
 This is the exponential function; it returns
 @tex
-$e$
+@math{e}
 @end tex
-@ifinfo
+@ifnottex
 @i{e}
-@end ifinfo
+@end ifnottex
 to the power @var{arg}.
 @tex
-$e$
+@math{e}
 @end tex
-@ifinfo
+@ifnottex
 @i{e}
-@end ifinfo
+@end ifnottex
 is a fundamental mathematical constant also called the base of natural
 logarithms.
 @end defun
@@ -992,11 +1029,11 @@ logarithms.
 This function returns the logarithm of @var{arg}, with base @var{base}.
 If you don't specify @var{base}, the base
 @tex
-$e$
+@math{e}
 @end tex
-@ifinfo
+@ifnottex
 @i{e}
-@end ifinfo
+@end ifnottex
 is used.  If @var{arg}
 is negative, the result is a NaN.
 @end defun
@@ -1053,9 +1090,9 @@ first call to @code{(random)} after you start Emacs always returns
 -1457731, and the second one always returns -7692030.  This
 repeatability is helpful for debugging.
 
-If you want truly unpredictable random numbers, execute @code{(random
-t)}.  This chooses a new seed based on the current time of day and on
-Emacs's process @sc{id} number.
+If you want random numbers that don't always come out the same, execute
+@code{(random t)}.  This chooses a new seed based on the current time of
+day and on Emacs's process @sc{id} number.
 
 @defun random &optional limit
 This function returns a pseudo-random integer.  Repeated calls return a