Mercurial > emacs
comparison lispref/display.texi @ 83038:30ccd595ccb0
Merged in changes from CVS HEAD
Patches applied:
* miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-98
Update from CVS
* miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-99
Update from CVS
* miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-100
Update from CVS
* miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-101
Update from CVS
* miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-102
Update from CVS
git-archimport-id: lorentey@elte.hu--2004/emacs--multi-tty--0--patch-78
author | Karoly Lorentey <lorentey@elte.hu> |
---|---|
date | Wed, 18 Feb 2004 17:10:32 +0000 |
parents | 3a7432ab26ae |
children | aa281cba47ea |
comparison
equal
deleted
inserted
replaced
83037:03a73693678e | 83038:30ccd595ccb0 |
---|---|
443 | 443 |
444 Normally you should not change the value of this variable. | 444 Normally you should not change the value of this variable. |
445 @end defvar | 445 @end defvar |
446 | 446 |
447 @defvar warning-prefix-function | 447 @defvar warning-prefix-function |
448 If non-@code{nil}, te value is a function to generate prefix text for | 448 If non-@code{nil}, the value is a function to generate prefix text for |
449 warnings. Programs can bind the variable to a suitable function. | 449 warnings. Programs can bind the variable to a suitable function. |
450 @code{display-warning} calls this function with the warnings buffer | 450 @code{display-warning} calls this function with the warnings buffer |
451 current, and the function can insert text in it. That text becomes | 451 current, and the function can insert text in it. That text becomes |
452 the beginning of the warning message. | 452 the beginning of the warning message. |
453 | 453 |
454 The function is called with two arguments, the severity level and its | 454 The function is called with two arguments, the severity level and its |
455 entry in @code{warning-levels}. It should return a list to use as the | 455 entry in @code{warning-levels}. It should return a list to use as the |
456 entry (this value need not be an actual member of | 456 entry (this value need not be an actual member of |
457 @code{warning-levels}). By constructing this value, the function to | 457 @code{warning-levels}). By constructing this value, the function can |
458 change the severity of the warning, or specify different handling for | 458 change the severity of the warning, or specify different handling for |
459 a given severity level. | 459 a given severity level. |
460 | 460 |
461 If the variable's value is @code{nil} then there is no function | 461 If the variable's value is @code{nil} then there is no function |
462 to call. | 462 to call. |
464 | 464 |
465 @defvar warning-series | 465 @defvar warning-series |
466 Programs can bind this variable to @code{t} to say that the next | 466 Programs can bind this variable to @code{t} to say that the next |
467 warning should begin a series. When several warnings form a series, | 467 warning should begin a series. When several warnings form a series, |
468 that means to leave point on the first warning of the series, rather | 468 that means to leave point on the first warning of the series, rather |
469 than keep move it for each warning so that it appears on the last one. | 469 than keep moving it for each warning so that it appears on the last one. |
470 The series ends when the local binding is unbound and | 470 The series ends when the local binding is unbound and |
471 @code{warning-series} becomes @code{nil} again. | 471 @code{warning-series} becomes @code{nil} again. |
472 | 472 |
473 The value can also be a symbol with a function definition. That is | 473 The value can also be a symbol with a function definition. That is |
474 equivalent to @code{t}, except that the next warning will also call | 474 equivalent to @code{t}, except that the next warning will also call |
598 a list, @code{(t)}, so that text whose @code{invisible} property | 598 a list, @code{(t)}, so that text whose @code{invisible} property |
599 is @code{t} remains invisible. | 599 is @code{t} remains invisible. |
600 @end defun | 600 @end defun |
601 | 601 |
602 @defun remove-from-invisibility-spec element | 602 @defun remove-from-invisibility-spec element |
603 This removeds the element @var{element} from | 603 This removes the element @var{element} from |
604 @code{buffer-invisibility-spec}. This does nothing if @var{element} | 604 @code{buffer-invisibility-spec}. This does nothing if @var{element} |
605 is not in the list. | 605 is not in the list. |
606 @end defun | 606 @end defun |
607 | 607 |
608 A convention for use of @code{buffer-invisibility-spec} is that a | 608 A convention for use of @code{buffer-invisibility-spec} is that a |
963 You can use @dfn{overlays} to alter the appearance of a buffer's text on | 963 You can use @dfn{overlays} to alter the appearance of a buffer's text on |
964 the screen, for the sake of presentation features. An overlay is an | 964 the screen, for the sake of presentation features. An overlay is an |
965 object that belongs to a particular buffer, and has a specified | 965 object that belongs to a particular buffer, and has a specified |
966 beginning and end. It also has properties that you can examine and set; | 966 beginning and end. It also has properties that you can examine and set; |
967 these affect the display of the text within the overlay. | 967 these affect the display of the text within the overlay. |
968 | |
969 An overlays uses markers to record its beginning and end; thus, | |
970 editing the text of the buffer adjusts the beginning and end of each | |
971 overlay so that it stays with the text. When you create the overlay, | |
972 you can specify whether text inserted at the beginning should be | |
973 inside the overlay or outside, and likewise for the end of the overlay. | |
968 | 974 |
969 @menu | 975 @menu |
970 * Overlay Properties:: How to read and set properties. | 976 * Overlay Properties:: How to read and set properties. |
971 What properties do to the screen display. | 977 What properties do to the screen display. |
972 * Managing Overlays:: Creating and moving overlays. | 978 * Managing Overlays:: Creating and moving overlays. |
1193 markers. If @var{buffer} is omitted, the overlay is created in the | 1199 markers. If @var{buffer} is omitted, the overlay is created in the |
1194 current buffer. | 1200 current buffer. |
1195 | 1201 |
1196 The arguments @var{front-advance} and @var{rear-advance} specify the | 1202 The arguments @var{front-advance} and @var{rear-advance} specify the |
1197 insertion type for the start of the overlay and for the end of the | 1203 insertion type for the start of the overlay and for the end of the |
1198 overlay, respectively. @xref{Marker Insertion Types}. | 1204 overlay, respectively. @xref{Marker Insertion Types}. If |
1205 @var{front-advance} is non-@code{nil}, text inserted at the beginning | |
1206 of the overlay is excluded from the overlay. If @var{read-advance} is | |
1207 non-@code{nil}, text inserted at the beginning of the overlay is | |
1208 included in the overlay. | |
1199 @end defun | 1209 @end defun |
1200 | 1210 |
1201 @defun overlay-start overlay | 1211 @defun overlay-start overlay |
1202 This function returns the position at which @var{overlay} starts, | 1212 This function returns the position at which @var{overlay} starts, |
1203 as an integer. | 1213 as an integer. |
1921 with older Emacs versions, you can use the following functions to set | 1931 with older Emacs versions, you can use the following functions to set |
1922 and examine the face attributes which existed in those versions. | 1932 and examine the face attributes which existed in those versions. |
1923 | 1933 |
1924 @tindex face-attribute-relative-p | 1934 @tindex face-attribute-relative-p |
1925 @defun face-attribute-relative-p attribute value | 1935 @defun face-attribute-relative-p attribute value |
1926 This function returns non-@code{nil} if @var{value}, when used as a | 1936 This function returns non-@code{nil} if @var{value}, when used as |
1927 the value of the face attribute @var{attribute}, is relative (that is, | 1937 the value of the face attribute @var{attribute}, is relative (that is, |
1928 if it modifies an underlying or inherited value of @var{attribute}). | 1938 if it modifies an underlying or inherited value of @var{attribute}). |
1929 @end defun | 1939 @end defun |
1930 | 1940 |
1931 @tindex merge-face-attribute | 1941 @tindex merge-face-attribute |
2494 @defun set-fontset-font name character fontname &optional frame | 2504 @defun set-fontset-font name character fontname &optional frame |
2495 This function modifies the existing fontset @var{name} to | 2505 This function modifies the existing fontset @var{name} to |
2496 use the font name @var{fontname} for the character @var{character}. | 2506 use the font name @var{fontname} for the character @var{character}. |
2497 | 2507 |
2498 If @var{name} is @code{nil}, this function modifies the default | 2508 If @var{name} is @code{nil}, this function modifies the default |
2499 fontset of which short name is @samp{fontset-default}. | 2509 fontset, whose short name is @samp{fontset-default}. |
2500 | 2510 |
2501 @var{character} may be a cons; @code{(@var{from} . @var{to})}, where | 2511 @var{character} may be a cons; @code{(@var{from} . @var{to})}, where |
2502 @var{from} and @var{to} are non-generic characters. In that case, use | 2512 @var{from} and @var{to} are non-generic characters. In that case, use |
2503 @var{fontname} for all characters in the range @var{from} and @var{to} | 2513 @var{fontname} for all characters in the range @var{from} and @var{to} |
2504 (inclusive). | 2514 (inclusive). |
2534 @section Fringes | 2544 @section Fringes |
2535 @cindex Fringes | 2545 @cindex Fringes |
2536 | 2546 |
2537 The @dfn{fringes} of a window are thin vertical strips down the | 2547 The @dfn{fringes} of a window are thin vertical strips down the |
2538 sides that are used for displaying bitmaps that indicate truncation, | 2548 sides that are used for displaying bitmaps that indicate truncation, |
2539 continuation, and horizontal scrolling, the overlay arrow. The | 2549 continuation, horizontal scrolling, and the overlay arrow. The |
2540 fringes normally appear between the display margins and the window | 2550 fringes normally appear between the display margins and the window |
2541 text, but you can put them outside the display margins for a specific | 2551 text, but you can put them outside the display margins for a specific |
2542 buffer by setting @code{fringes-outside-margins} buffer-locally to a | 2552 buffer by setting @code{fringes-outside-margins} buffer-locally to a |
2543 non-@code{nil} value. | 2553 non-@code{nil} value. |
2544 | 2554 |
2557 fringe in pixels. | 2567 fringe in pixels. |
2558 @end defvar | 2568 @end defvar |
2559 | 2569 |
2560 The values of these variables take effect when you display the | 2570 The values of these variables take effect when you display the |
2561 buffer in a window. If you change them while the buffer is visible, | 2571 buffer in a window. If you change them while the buffer is visible, |
2562 you can call @code{set-window-buffer} to display it in a window again. | 2572 you can call @code{set-window-buffer} to display it once again in the |
2573 same window, to make the changes take effect. | |
2563 | 2574 |
2564 @defun set-window-fringes window left &optional right outside-margins | 2575 @defun set-window-fringes window left &optional right outside-margins |
2565 This function sets the fringe widthes of window @var{window}. | 2576 This function sets the fringe widths of window @var{window}. |
2566 If @var{window} is @code{nil}, the selected window is used. | 2577 If @var{window} is @code{nil}, the selected window is used. |
2567 | 2578 |
2568 The argument @var{left} specifies the width in pixels of the left | 2579 The argument @var{left} specifies the width in pixels of the left |
2569 fringe, and likewise @var{right} for the right fringe. A value of | 2580 fringe, and likewise @var{right} for the right fringe. A value of |
2570 @code{nil} for either one stands for the default width. If | 2581 @code{nil} for either one stands for the default width. If |