summaryrefslogtreecommitdiff
path: root/doc/emacs/display.texi
diff options
context:
space:
mode:
authorPaul Eggert <eggert@cs.ucla.edu>2022-04-28 10:51:01 -0700
committerPaul Eggert <eggert@cs.ucla.edu>2022-04-28 10:53:10 -0700
commita41a181db5f3aca043ed42b228dc56a6403c21a5 (patch)
treec960624c9d5c5f7b5237dcc8fc510fd4d961129f /doc/emacs/display.texi
parent75366be2c0aa877eb6acf1b8a1c5312d6504caa9 (diff)
downloademacs-a41a181db5f3aca043ed42b228dc56a6403c21a5.tar.gz
Document \807 etc. in raw byte display
* doc/emacs/display.texi (Display Custom): Mention potential confusion in raw byte display.
Diffstat (limited to 'doc/emacs/display.texi')
-rw-r--r--doc/emacs/display.texi11
1 files changed, 11 insertions, 0 deletions
diff --git a/doc/emacs/display.texi b/doc/emacs/display.texi
index 2ac0dca6223..7a6c7f391b9 100644
--- a/doc/emacs/display.texi
+++ b/doc/emacs/display.texi
@@ -2097,3 +2097,14 @@ argument to suppress the effect of bold-face in this case.
byte with a decimal value of 128 is displayed as @code{\200}. To
change display to the hexadecimal format of @code{\x80}, set the
variable @code{display-raw-bytes-as-hex} to @code{t}.
+Care may be needed when interpreting a raw byte when copying
+text from a terminal containing an Emacs session, or when a terminal's
+@code{escape-glyph} face looks like the default face. For example, by
+default Emacs displays the four characters @samp{\}, @samp{2},
+@samp{0}, @samp{0} with the same characters it displays a byte with
+decimal value 128. The problem can be worse with hex displays, where
+the raw byte 128 followed by the character @samp{7} is displayed as
+@code{\x807}, which Emacs Lisp reads as the single character U+0807
+SAMARITAN LETTER IT; this confusion does not occur with the
+corresponding octal display @code{\2007} because octal escapes contain
+at most three digits.