Mercurial > hg > xemacs-beta

comparison man/lispref/display.texi @ 5791:9fae6227ede5

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Silence texinfo 5.2 warnings, primarily by adding next, prev, and up pointers to all nodes. See xemacs-patches message with ID <5315f7bf.sHpFD7lXYR05GH6E%james@xemacs.org>.
author Jerry James <james@xemacs.org>
date Thu, 27 Mar 2014 08:59:03 -0600
parents 62b9ef1ed4ac
children
comparison
equal deleted inserted replaced
5790:dcf9067f26bb 5791:9fae6227ede5
22 * Usual Display:: The usual conventions for displaying nonprinting chars. 22 * Usual Display:: The usual conventions for displaying nonprinting chars.
23 * Display Tables:: How to specify other conventions. 23 * Display Tables:: How to specify other conventions.
24 * Beeping:: Audible signal to the user. 24 * Beeping:: Audible signal to the user.
25 @end menu 25 @end menu
26 26
27 @node Refresh Screen 27 @node Refresh Screen, Truncation, Display, Display
28 @section Refreshing the Screen 28 @section Refreshing the Screen
29 29
30 The function @code{redraw-frame} redisplays the entire contents of a 30 The function @code{redraw-frame} redisplays the entire contents of a
31 given frame. @xref{Frames}. 31 given frame. @xref{Frames}.
32 32
80 @defun force-cursor-redisplay &optional frame 80 @defun force-cursor-redisplay &optional frame
81 This function causes an immediate update of the cursor on @var{frame}, 81 This function causes an immediate update of the cursor on @var{frame},
82 which defaults to the selected frame. 82 which defaults to the selected frame.
83 @end defun 83 @end defun
84 84
85 @node Truncation 85 @node Truncation, The Echo Area, Refresh Screen, Display
86 @section Truncation 86 @section Truncation
87 @cindex line wrapping 87 @cindex line wrapping
88 @cindex continuation lines 88 @cindex continuation lines
89 @cindex @samp{$} in display 89 @cindex @samp{$} in display
90 @cindex @samp{\} in display 90 @cindex @samp{\} in display
156 156
157 This variable is automatically local in every buffer. 157 This variable is automatically local in every buffer.
158 @end defvar 158 @end defvar
159 @end ignore 159 @end ignore
160 160
161 @node The Echo Area 161 @node The Echo Area, Warnings, Truncation, Display
162 @section The Echo Area 162 @section The Echo Area
163 @cindex error display 163 @cindex error display
164 @cindex echo area 164 @cindex echo area
165 165
166 The @dfn{echo area} is used for displaying messages made with the 166 The @dfn{echo area} is used for displaying messages made with the
354 354
355 @menu 355 @menu
356 * Customizing Message Display:: 356 * Customizing Message Display::
357 @end menu 357 @end menu
358 358
359 @node Customizing Message Display 359 @node Customizing Message Display, , The Echo Area, The Echo Area
360 @subsection Customizing Message Display 360 @subsection Customizing Message Display
361 361
362 Message display function specify message intended for echo area by 362 Message display function specify message intended for echo area by
363 putting message text into @code{" *Echo Area*"} buffer. When event 363 putting message text into @code{" *Echo Area*"} buffer. When event
364 loop code decides to update display after displaying the message, text 364 loop code decides to update display after displaying the message, text
387 buffer). It must wait after displaying message so that user can read 387 buffer). It must wait after displaying message so that user can read
388 it. By default, when the variable value is @code{nil}, the equivalent 388 it. By default, when the variable value is @code{nil}, the equivalent
389 of @code{(sit-for 2)} is run. 389 of @code{(sit-for 2)} is run.
390 @end defvar 390 @end defvar
391 391
392 @node Warnings 392 @node Warnings, Invisible Text, The Echo Area, Display
393 @section Warnings 393 @section Warnings
394 394
395 XEmacs contains a facility for unified display of various warnings. 395 XEmacs contains a facility for unified display of various warnings.
396 Unlike errors, warnings are displayed in the situations when XEmacs 396 Unlike errors, warnings are displayed in the situations when XEmacs
397 encounters a problem that is recoverable, but which should be fixed for 397 encounters a problem that is recoverable, but which should be fixed for
498 displayed. The warning will still logged in the *Warnings* buffer 498 displayed. The warning will still logged in the *Warnings* buffer
499 (unless also contained in `log-warning-suppressed-classes'), but the 499 (unless also contained in `log-warning-suppressed-classes'), but the
500 buffer will not be automatically popped up. 500 buffer will not be automatically popped up.
501 @end defvar 501 @end defvar
502 502
503 @node Invisible Text 503 @node Invisible Text, Selective Display, Warnings, Display
504 @section Invisible Text 504 @section Invisible Text
505 505
506 @cindex invisible text 506 @cindex invisible text
507 You can make characters @dfn{invisible}, so that they do not appear on 507 You can make characters @dfn{invisible}, so that they do not appear on
508 the screen, with the @code{invisible} property. This can be either a 508 the screen, with the @code{invisible} property. This can be either a
560 whether the text is invisible. However, the user-level line motion 560 whether the text is invisible. However, the user-level line motion
561 commands explicitly ignore invisible newlines. Since this causes a 561 commands explicitly ignore invisible newlines. Since this causes a
562 slow-down of these commands it is turned off by default, controlled by 562 slow-down of these commands it is turned off by default, controlled by
563 the variable @code{line-move-ignore-invisible}. 563 the variable @code{line-move-ignore-invisible}.
564 564
565 @node Selective Display 565 @node Selective Display, Overlay Arrow, Invisible Text, Display
566 @section Selective Display 566 @section Selective Display
567 @cindex selective display 567 @cindex selective display
568 568
569 @dfn{Selective display} is a pair of features that hide certain 569 @dfn{Selective display} is a pair of features that hide certain
570 lines on the screen. 570 lines on the screen.
676 676
677 You can use a display table to substitute other text for the ellipsis 677 You can use a display table to substitute other text for the ellipsis
678 (@samp{@dots{}}). @xref{Display Tables}. 678 (@samp{@dots{}}). @xref{Display Tables}.
679 @end defvar 679 @end defvar
680 680
681 @node Overlay Arrow 681 @node Overlay Arrow, Temporary Displays, Selective Display, Display
682 @section The Overlay Arrow 682 @section The Overlay Arrow
683 @cindex overlay arrow 683 @cindex overlay arrow
684 684
685 The @dfn{overlay arrow} is useful for directing the user's attention 685 The @dfn{overlay arrow} is useful for directing the user's attention
686 to a particular line in a buffer. For example, in the modes used for 686 to a particular line in a buffer. For example, in the modes used for
711 @end defvar 711 @end defvar
712 712
713 You can do the same job by creating an extent with a 713 You can do the same job by creating an extent with a
714 @code{begin-glyph} property. @xref{Extent Properties}. 714 @code{begin-glyph} property. @xref{Extent Properties}.
715 715
716 @node Temporary Displays 716 @node Temporary Displays, Blinking, Overlay Arrow, Display
717 @section Temporary Displays 717 @section Temporary Displays
718 718
719 Temporary displays are used by commands to put output into a buffer 719 Temporary displays are used by commands to put output into a buffer
720 and then present it to the user for perusal rather than for editing. 720 and then present it to the user for perusal rather than for editing.
721 Many of the help commands use this feature. 721 Many of the help commands use this feature.
827 This function works by actually changing the text in the buffer. As a 827 This function works by actually changing the text in the buffer. As a
828 result, if you later undo in this buffer, you will see the message come 828 result, if you later undo in this buffer, you will see the message come
829 and go. 829 and go.
830 @end defun 830 @end defun
831 831
832 @node Blinking 832 @node Blinking, Usual Display, Temporary Displays, Display
833 @section Blinking Parentheses 833 @section Blinking Parentheses
834 @cindex parenthesis matching 834 @cindex parenthesis matching
835 @cindex blinking 835 @cindex blinking
836 @cindex balancing parentheses 836 @cindex balancing parentheses
837 @cindex close parenthesis 837 @cindex close parenthesis
893 (blink-matching-open))) 893 (blink-matching-open)))
894 @end group 894 @end group
895 @end smallexample 895 @end smallexample
896 @end deffn 896 @end deffn
897 897
898 @node Usual Display 898 @node Usual Display, Display Tables, Blinking, Display
899 @section Usual Display Conventions 899 @section Usual Display Conventions
900 900
901 The usual display conventions define how to display each character 901 The usual display conventions define how to display each character
902 code. You can override these conventions by setting up a display table 902 code. You can override these conventions by setting up a display table
903 (@pxref{Display Tables}). Here are the usual display conventions: 903 (@pxref{Display Tables}). Here are the usual display conventions:
957 displaying tab characters in Emacs buffers. The default is 8. Note 957 displaying tab characters in Emacs buffers. The default is 8. Note
958 that this feature is completely independent from the user-settable tab 958 that this feature is completely independent from the user-settable tab
959 stops used by the command @code{tab-to-tab-stop}. @xref{Indent Tabs}. 959 stops used by the command @code{tab-to-tab-stop}. @xref{Indent Tabs}.
960 @end defopt 960 @end defopt
961 961
962 @node Display Tables 962 @node Display Tables, Beeping, Usual Display, Display
963 @section Display Tables 963 @section Display Tables
964 964
965 @cindex display table 965 @cindex display table
966 You can use the @dfn{display table} feature to control how all 256 966 You can use the @dfn{display table} feature to control how all 256
967 possible character codes display on the screen. This is useful for 967 possible character codes display on the screen. This is useful for
983 @ignore Not yet working in XEmacs? 983 @ignore Not yet working in XEmacs?
984 * ISO Latin 1:: How to use display tables 984 * ISO Latin 1:: How to use display tables
985 to support the ISO Latin 1 character set. 985 to support the ISO Latin 1 character set.
986 @end ignore 986 @end ignore
987 987
988 @node Display Table Format 988 @node Display Table Format, Active Display Table, Display Tables, Display Tables
989 @subsection Display Table Format 989 @subsection Display Table Format
990 990
991 A display table is an array of 256 elements. (In FSF Emacs, a display 991 A display table is an array of 256 elements. (In FSF Emacs, a display
992 table is 262 elements. The six extra elements specify the truncation 992 table is 262 elements. The six extra elements specify the truncation
993 and continuation glyphs, etc. This method is very kludgey, and in 993 and continuation glyphs, etc. This method is very kludgey, and in
1020 (aset disptab i (concat "^" (char-to-string (+ i 64))))) 1020 (aset disptab i (concat "^" (char-to-string (+ i 64)))))
1021 (setq i (1+ i))) 1021 (setq i (1+ i)))
1022 (aset disptab 127 "^?")) 1022 (aset disptab 127 "^?"))
1023 @end example 1023 @end example
1024 1024
1025 @node Active Display Table 1025 @node Active Display Table, Character Descriptors, Display Table Format, Display Tables
1026 @subsection Active Display Table 1026 @subsection Active Display Table
1027 @cindex active display table 1027 @cindex active display table
1028 1028
1029 The active display table is controlled by the variable 1029 The active display table is controlled by the variable
1030 @code{current-display-table}. This is a specifier, which means 1030 @code{current-display-table}. This is a specifier, which means
1109 this is set using @code{set-face-display-table}. @xref{Faces}. 1109 this is set using @code{set-face-display-table}. @xref{Faces}.
1110 1110
1111 If no display table can be determined for a particular window, 1111 If no display table can be determined for a particular window,
1112 then XEmacs uses the usual display conventions. @xref{Usual Display}. 1112 then XEmacs uses the usual display conventions. @xref{Usual Display}.
1113 1113
1114 @node Character Descriptors 1114 @node Character Descriptors, , Active Display Table, Display Tables
1115 @subsection Character Descriptors 1115 @subsection Character Descriptors
1116 1116
1117 @cindex character descriptor 1117 @cindex character descriptor
1118 Each element of the display-table vector describes how to display 1118 Each element of the display-table vector describes how to display
1119 a particular character and is called a @dfn{character descriptor}. 1119 a particular character and is called a @dfn{character descriptor}.
1163 You can load the appropriate display table for your terminal 1163 You can load the appropriate display table for your terminal
1164 automatically by writing a terminal-specific Lisp file for the terminal 1164 automatically by writing a terminal-specific Lisp file for the terminal
1165 type. 1165 type.
1166 @end ignore 1166 @end ignore
1167 1167
1168 @node Beeping 1168 @node Beeping, , Display Tables, Display
1169 @section Beeping 1169 @section Beeping
1170 @cindex beeping 1170 @cindex beeping
1171 @cindex bell 1171 @cindex bell
1172 @cindex sound 1172 @cindex sound
1173 1173