# HG changeset patch
# User aidan
# Date 1195063612 0
# Node ID 9db20cbbe4c7be82a3cdface3f84545b3812ef02
# Parent  25de9b807e3fd0d9274ebfc406e023daeef517a1
[xemacs-hg @ 2007-11-14 18:06:47 by aidan]
Correct some documentation on character representation and display.

diff -r 25de9b807e3f -r 9db20cbbe4c7 man/ChangeLog
--- a/man/ChangeLog	Tue Nov 13 22:50:51 2007 +0000
+++ b/man/ChangeLog	Wed Nov 14 18:06:52 2007 +0000
@@ -1,3 +1,10 @@
+2007-11-14  Aidan Kehoe  <kehoea@parhasard.net>
+
+	* xemacs/keystrokes.texi (Character Representation):
+	Clarify the description of which characters are displayed as
+	themselves and which as octal escapes bzw. "control" characters
+	with an initial caret. 
+
 2007-10-15  Adrian Aichner  <adrian@xemacs.org>
 
 	* Makefile (info_files): Sync nt/xemacs.mak and man/Makefile.
diff -r 25de9b807e3f -r 9db20cbbe4c7 man/xemacs/keystrokes.texi
--- a/man/xemacs/keystrokes.texi	Tue Nov 13 22:50:51 2007 +0000
+++ b/man/xemacs/keystrokes.texi	Wed Nov 14 18:06:52 2007 +0000
@@ -444,18 +444,23 @@
 buffers.  @xref{Key Sequences}, for information on representing key
 sequences to create key bindings. 
 
-  ASCII graphic characters in Emacs buffers are displayed with their
-graphics.  @key{LFD} is the same as a newline character; it is displayed
-by starting a new line.  @key{TAB} is displayed by moving to the next
-tab stop column (usually every 8 spaces).  Other control characters are
-displayed as a caret (@samp{^}) followed by the non-control version of
-the character; thus, @kbd{C-a} is displayed as @samp{^A}.  Non-ASCII
-characters 128 and up are displayed with octal escape sequences; thus,
-character code 243 (octal), also called @kbd{M-#} when used as an input
-character, is displayed as @samp{\243}.
+  Printable characters (letters, numbers, punctuation and so on) in
+XEmacs buffers are displayed as such. @key{LFD} (line feed, character
+code @samp{\012} (octal)) is the same as a newline character; it is
+displayed by starting a new line.  @key{TAB} is displayed by moving to
+the next tab stop column (usually every 8 spaces).  Other control
+characters below #x20 (hexadecimal) are displayed as a caret (@samp{^})
+followed by the non-control version of the character; thus, @kbd{C-a} is
+displayed as @samp{^A}.  Characters between (hexadecimal) #x80 and #xA0
+are displayed with octal escape sequences; thus, character code 243
+(octal), also called @kbd{M-#} when used as an input character, is
+displayed as @samp{\243}.
 
 The variable @code{ctl-arrow} may be used to alter this behavior.
-@xref{Display Vars}.
+@xref{Display Vars}. As a rule, its value limits octal display to those
+characters in the range just mentioned, and otherwise characters are
+treated as printable, and will be displayed as themselves when the
+relevant fonts are available. 
 
 @node Commands, Non-Latin keyboards, Character Representation, Keystrokes
 @section Keys and Commands