[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] master 9189afc: Improve documentation of bignums
From: |
Eli Zaretskii |
Subject: |
[Emacs-diffs] master 9189afc: Improve documentation of bignums |
Date: |
Fri, 17 Aug 2018 10:58:02 -0400 (EDT) |
branch: master
commit 9189afc1a823703e1cef648538ac4b22182eb099
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>
Improve documentation of bignums
* etc/NEWS: Enhance the announcement of bignums.
* doc/lispref/numbers.texi (Integer Basics): Add a missing
period. Reported by Basil L. Contovounesios <address@hidden>.
---
doc/lispref/numbers.texi | 2 +-
etc/NEWS | 15 ++++++++++++---
2 files changed, 13 insertions(+), 4 deletions(-)
diff --git a/doc/lispref/numbers.texi b/doc/lispref/numbers.texi
index bd633b7..37d2c31 100644
--- a/doc/lispref/numbers.texi
+++ b/doc/lispref/numbers.texi
@@ -37,7 +37,7 @@ numbers have a fixed amount of precision.
Integers in Emacs Lisp can have arbitrary precision.
Under the hood, though, there are two kinds of integers: smaller
-ones, called @dfn{fixnums}, and larger ones, called @dfn{bignums}
+ones, called @dfn{fixnums}, and larger ones, called @dfn{bignums}.
Some functions in Emacs only accept fixnums. Also, while fixnums can
always be compared for equality with @code{eq}, bignums require the
use of @code{eql}.
diff --git a/etc/NEWS b/etc/NEWS
index d1a6868..a9f8ed2 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -858,9 +858,18 @@ otherwise, it returns nil. 'format-proper-list-p' is now
an obsolete
alias for the new function.
+++
-** Emacs Lisp integers can be of arbitrary precision. The new
-predicates 'bignump' and 'fixnump' can be used to distinguish between
-the types of integers.
+** Emacs Lisp integers can now be of arbitrary size.
+Emacs uses the GNU Multiple Precision (GMP) library to support
+integers whose size is too large to support natively. The integers
+supported natively are known as "fixnums", while the larger ones are
+"bignums". The new predicates 'bignump' and 'fixnump' can be used to
+distinguish between these two types of integers.
+
+All the arithmetic, comparison, and logical (a.k.a. "bitwise")
+operations where bignums make sense now support both fixnums and
+bignums. However, note that unlike fixnums, bignums will not compare
+equal with 'eq', you must use 'eql' instead. (Numerical comparison
+with '=' works on both, of course.)
** define-minor-mode automatically documents the meaning of ARG
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] master 9189afc: Improve documentation of bignums,
Eli Zaretskii <=