From 754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 Mon Sep 17 00:00:00 2001
From: Craig Jennings <c@cjennings.net>
Date: Sun, 7 Apr 2024 13:41:34 -0500
Subject: new repository

---
 devdocs/elisp/usual-display.html | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)
 create mode 100644 devdocs/elisp/usual-display.html

(limited to 'devdocs/elisp/usual-display.html')

diff --git a/devdocs/elisp/usual-display.html b/devdocs/elisp/usual-display.html
new file mode 100644
index 00000000..95db68cf
--- /dev/null
+++ b/devdocs/elisp/usual-display.html
@@ -0,0 +1,18 @@
+ <h4 class="subsection">Usual Display Conventions</h4> <p>Here are the conventions for displaying each character code (in the absence of a display table, which can override these conventions; see <a href="display-tables">Display Tables</a>). </p>  <ul> <li> The <em>printable <acronym>ASCII</acronym> characters</em>, character codes 32 through 126 (consisting of numerals, English letters, and symbols like ‘<samp>#</samp>’) are displayed literally. </li>
+<li> The tab character (character code 9) displays as whitespace stretching up to the next tab stop column. See <a href="https://www.gnu.org/software/emacs/manual/html_node/emacs/Text-Display.html#Text-Display">Text Display</a> in <cite>The GNU Emacs Manual</cite>. The variable <code>tab-width</code> controls the number of spaces per tab stop (see below). </li>
+<li> The newline character (character code 10) has a special effect: it ends the preceding line and starts a new line. </li>
+<li>  The non-printable <em><acronym>ASCII</acronym> control characters</em>—character codes 0 through 31, as well as the <tt class="key">DEL</tt> character (character code 127)—display in one of two ways according to the variable <code>ctl-arrow</code>. If this variable is non-<code>nil</code> (the default), these characters are displayed as sequences of two glyphs, where the first glyph is ‘<samp>^</samp>’ (a display table can specify a glyph to use instead of ‘<samp>^</samp>’); e.g., the <tt class="key">DEL</tt> character is displayed as ‘<samp>^?</samp>’. <p>If <code>ctl-arrow</code> is <code>nil</code>, these characters are displayed as octal escapes (see below). </p> <p>This rule also applies to carriage return (character code 13), if that character appears in the buffer. But carriage returns usually do not appear in buffer text; they are eliminated as part of end-of-line conversion (see <a href="coding-system-basics">Coding System Basics</a>). </p> </li>
+<li>  <em>Raw bytes</em> are non-<acronym>ASCII</acronym> characters with codes 128 through 255 (see <a href="text-representations">Text Representations</a>). These characters display as <em>octal escapes</em>: sequences of four glyphs, where the first glyph is the <acronym>ASCII</acronym> code for ‘<samp>\</samp>’, and the others are digit characters representing the character code in octal. (A display table can specify a glyph to use instead of ‘<samp>\</samp>’.) </li>
+<li> Each non-<acronym>ASCII</acronym> character with code above 255 is displayed literally, if the terminal supports it. If the terminal does not support it, the character is said to be <em>glyphless</em>, and it is usually displayed using a placeholder glyph. For example, if a graphical terminal has no font for a character, Emacs usually displays a box containing the character code in hexadecimal. See <a href="glyphless-chars">Glyphless Chars</a>. </li>
+</ul> <p>The above display conventions apply even when there is a display table, for any character whose entry in the active display table is <code>nil</code>. Thus, when you set up a display table, you need only specify the characters for which you want special display behavior. </p> <p>The following variables affect how certain characters are displayed on the screen. Since they change the number of columns the characters occupy, they also affect the indentation functions. They also affect how the mode line is displayed; if you want to force redisplay of the mode line using the new values, call the function <code>force-mode-line-update</code> (see <a href="mode-line-format">Mode Line Format</a>). </p> <dl> <dt id="ctl-arrow">User Option: <strong>ctl-arrow</strong>
+</dt> <dd>
+ <p>This buffer-local variable controls how control characters are displayed. If it is non-<code>nil</code>, they are displayed as a caret followed by the character: ‘<samp>^A</samp>’. If it is <code>nil</code>, they are displayed as octal escapes: a backslash followed by three octal digits, as in ‘<samp>\001</samp>’. </p>
+</dd>
+</dl> <dl> <dt id="tab-width">User Option: <strong>tab-width</strong>
+</dt> <dd><p>The value of this buffer-local variable is the spacing between tab stops used for displaying tab characters in Emacs buffers. The value is in units of columns, and the default is 8. Note that this feature is completely independent of the user-settable tab stops used by the command <code>tab-to-tab-stop</code>. See <a href="indent-tabs">Indent Tabs</a>. </p></dd>
+</dl><div class="_attribution">
+  <p class="_attribution-p">
+    Copyright &copy; 1990-1996, 1998-2022 Free Software Foundation, Inc. <br>Licensed under the GNU GPL license.<br>
+    <a href="https://www.gnu.org/software/emacs/manual/html_node/elisp/Usual-Display.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/Usual-Display.html</a>
+  </p>
+</div>
-- 
cgit v1.2.3