summaryrefslogtreecommitdiff
path: root/doc/lispref
diff options
context:
space:
mode:
authorGlenn Morris <rgm@gnu.org>2020-07-11 09:25:04 -0700
committerGlenn Morris <rgm@gnu.org>2020-07-11 09:25:04 -0700
commit398a2680616112675afe26478706a3cea9e76158 (patch)
tree24751dcc7238b3b65612f670569f10484f1d9fcd /doc/lispref
parent6cc35829e4772479abed1f46f0c51daa24d070e0 (diff)
parentc04b92104c2bc4c1a719e06fbe11045a204c36a0 (diff)
downloademacs-398a2680616112675afe26478706a3cea9e76158.tar.gz
Merge from origin/emacs-27
c04b92104c Add commentary in gtkutil.c 6290850dac Consistently stylize eldoc as ElDoc in prose 136e931189 Improve documentation of "C-u C-x =" 1f52771fd3 Mention floating rounding issues c892ae65b4 Repair global-auto-revert-ignore-modes (bug#42271) 3a446a02fb ; * src/xdisp.c (decode_mode_spec): Fix commentary. 79f381b4a6 One more improvement of left/right-fringe display spec docs 1279bdb072 Another clarification of left/right-fringe display spec # Conflicts: # doc/emacs/programs.texi
Diffstat (limited to 'doc/lispref')
-rw-r--r--doc/lispref/display.texi12
-rw-r--r--doc/lispref/numbers.texi3
2 files changed, 12 insertions, 3 deletions
diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index d7aab4ae62f..25eabd6c3fc 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -4275,9 +4275,15 @@ a display specification has the form
@var{fringe} is either the symbol @code{left-fringe} or
@code{right-fringe}. @var{bitmap} is a symbol identifying the bitmap
to display. The optional @var{face} names a face whose foreground and
-background colors are to be used to display the bitmap; this face is
-automatically merged with the @code{fringe} face. If @var{face} is
-omitted, that means to use the @code{default} face.
+background colors are to be used to display the bitmap, using the
+attributes of the @code{fringe} face for colors that @var{face} didn't
+specify. If @var{face} is omitted, that means to use the attributes
+of the @code{default} face for the colors which the @code{fringe} face
+didn't specify. For predictable results that don't depend on the
+attributes of the @code{default} and @code{fringe} faces, we recommend
+you never omit @var{face}, but always provide a specific face. In
+particular, if you want the bitmap to be always displayed in the
+@code{fringe} face, use @code{fringe} as @var{face}.
For instance, to display an arrow in the left fringe, using the
@code{warning} face, you could say something like:
diff --git a/doc/lispref/numbers.texi b/doc/lispref/numbers.texi
index 4002b36ce50..f018ef4c7c0 100644
--- a/doc/lispref/numbers.texi
+++ b/doc/lispref/numbers.texi
@@ -227,6 +227,9 @@ you are using. On all computers supported by Emacs, this is
and is discussed further in David Goldberg's paper
``@url{https://docs.oracle.com/cd/E19957-01/806-3568/ncg_goldberg.html,
What Every Computer Scientist Should Know About Floating-Point Arithmetic}''.
+On modern platforms, floating-point operations follow the IEEE-754
+standard closely; however, results are not always rounded correctly on
+some obsolescent platforms, notably 32-bit x86.
The read syntax for floating-point numbers requires either a decimal
point, an exponent, or both. Optional signs (@samp{+} or @samp{-})