summaryrefslogtreecommitdiff
path: root/devdocs/elisp/active-display-table.html
blob: 340c81d0a86422c3528b143d7ce8cbfef5f4379e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
 <h4 class="subsection">Active Display Table</h4>  <p>Each window can specify a display table, and so can each buffer. The window’s display table, if there is one, takes precedence over the buffer’s display table. If neither exists, Emacs tries to use the standard display table; if that is <code>nil</code>, Emacs uses the usual character display conventions (see <a href="usual-display">Usual Display</a>). </p> <p>Note that display tables affect how the mode line is displayed, so if you want to force redisplay of the mode line using a new display table, call <code>force-mode-line-update</code> (see <a href="mode-line-format">Mode Line Format</a>). </p> <dl> <dt id="window-display-table">Function: <strong>window-display-table</strong> <em>&amp;optional window</em>
</dt> <dd><p>This function returns <var>window</var>’s display table, or <code>nil</code> if there is none. The default for <var>window</var> is the selected window. </p></dd>
</dl> <dl> <dt id="set-window-display-table">Function: <strong>set-window-display-table</strong> <em>window table</em>
</dt> <dd><p>This function sets the display table of <var>window</var> to <var>table</var>. The argument <var>table</var> should be either a display table or <code>nil</code>. </p></dd>
</dl> <dl> <dt id="buffer-display-table">Variable: <strong>buffer-display-table</strong>
</dt> <dd><p>This variable is automatically buffer-local in all buffers; its value specifies the buffer’s display table. If it is <code>nil</code>, there is no buffer display table. </p></dd>
</dl> <dl> <dt id="standard-display-table">Variable: <strong>standard-display-table</strong>
</dt> <dd><p>The value of this variable is the standard display table, which is used when Emacs is displaying a buffer in a window with neither a window display table nor a buffer display table defined, or when Emacs is outputting text to the standard output or error streams. Although its default is typically <code>nil</code>, in an interactive session if the terminal cannot display curved quotes, its default maps curved quotes to ASCII approximations. See <a href="text-quoting-style">Text Quoting Style</a>. </p></dd>
</dl> <p>The <samp>disp-table</samp> library defines several functions for changing the standard display table. </p><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/Active-Display-Table.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/Active-Display-Table.html</a>
  </p>
</div>