From 812a234187437d9f9f18cb59fdb97c04a633b6e0 Mon Sep 17 00:00:00 2001 From: "Richard M. Stallman" Date: Mon, 16 Feb 2004 22:16:13 +0000 Subject: [PATCH] Minor fixes. (Overlays): Explain overlays use markers. (Managing Overlays): Explain front-advance and rear-advance in more detail. --- lispref/display.texi | 31 +++++++++++++++++++++---------- 1 file changed, 21 insertions(+), 10 deletions(-) diff --git a/lispref/display.texi b/lispref/display.texi index 54ba32c39da..89e9998094c 100644 --- a/lispref/display.texi +++ b/lispref/display.texi @@ -445,7 +445,7 @@ Normally you should not change the value of this variable. @end defvar @defvar warning-prefix-function -If non-@code{nil}, te value is a function to generate prefix text for +If non-@code{nil}, the value is a function to generate prefix text for warnings. Programs can bind the variable to a suitable function. @code{display-warning} calls this function with the warnings buffer current, and the function can insert text in it. That text becomes @@ -454,7 +454,7 @@ the beginning of the warning message. The function is called with two arguments, the severity level and its entry in @code{warning-levels}. It should return a list to use as the entry (this value need not be an actual member of -@code{warning-levels}). By constructing this value, the function to +@code{warning-levels}). By constructing this value, the function can change the severity of the warning, or specify different handling for a given severity level. @@ -466,7 +466,7 @@ to call. Programs can bind this variable to @code{t} to say that the next warning should begin a series. When several warnings form a series, that means to leave point on the first warning of the series, rather -than keep move it for each warning so that it appears on the last one. +than keep moving it for each warning so that it appears on the last one. The series ends when the local binding is unbound and @code{warning-series} becomes @code{nil} again. @@ -600,7 +600,7 @@ is @code{t} remains invisible. @end defun @defun remove-from-invisibility-spec element -This removeds the element @var{element} from +This removes the element @var{element} from @code{buffer-invisibility-spec}. This does nothing if @var{element} is not in the list. @end defun @@ -966,6 +966,12 @@ object that belongs to a particular buffer, and has a specified beginning and end. It also has properties that you can examine and set; these affect the display of the text within the overlay. +An overlays uses markers to record its beginning and end; thus, +editing the text of the buffer adjusts the beginning and end of each +overlay so that it stays with the text. When you create the overlay, +you can specify whether text inserted at the beginning should be +inside the overlay or outside, and likewise for the end of the overlay. + @menu * Overlay Properties:: How to read and set properties. What properties do to the screen display. @@ -1195,7 +1201,11 @@ current buffer. The arguments @var{front-advance} and @var{rear-advance} specify the insertion type for the start of the overlay and for the end of the -overlay, respectively. @xref{Marker Insertion Types}. +overlay, respectively. @xref{Marker Insertion Types}. If +@var{front-advance} is non-@code{nil}, text inserted at the beginning +of the overlay is excluded from the overlay. If @var{read-advance} is +non-@code{nil}, text inserted at the beginning of the overlay is +included in the overlay. @end defun @defun overlay-start overlay @@ -1923,7 +1933,7 @@ and examine the face attributes which existed in those versions. @tindex face-attribute-relative-p @defun face-attribute-relative-p attribute value -This function returns non-@code{nil} if @var{value}, when used as a +This function returns non-@code{nil} if @var{value}, when used as the value of the face attribute @var{attribute}, is relative (that is, if it modifies an underlying or inherited value of @var{attribute}). @end defun @@ -2496,7 +2506,7 @@ This function modifies the existing fontset @var{name} to use the font name @var{fontname} for the character @var{character}. If @var{name} is @code{nil}, this function modifies the default -fontset of which short name is @samp{fontset-default}. +fontset, whose short name is @samp{fontset-default}. @var{character} may be a cons; @code{(@var{from} . @var{to})}, where @var{from} and @var{to} are non-generic characters. In that case, use @@ -2536,7 +2546,7 @@ does that, this function's value may not be accurate. The @dfn{fringes} of a window are thin vertical strips down the sides that are used for displaying bitmaps that indicate truncation, -continuation, and horizontal scrolling, the overlay arrow. The +continuation, horizontal scrolling, and the overlay arrow. The fringes normally appear between the display margins and the window text, but you can put them outside the display margins for a specific buffer by setting @code{fringes-outside-margins} buffer-locally to a @@ -2559,10 +2569,11 @@ fringe in pixels. The values of these variables take effect when you display the buffer in a window. If you change them while the buffer is visible, -you can call @code{set-window-buffer} to display it in a window again. +you can call @code{set-window-buffer} to display it once again in the +same window, to make the changes take effect. @defun set-window-fringes window left &optional right outside-margins -This function sets the fringe widthes of window @var{window}. +This function sets the fringe widths of window @var{window}. If @var{window} is @code{nil}, the selected window is used. The argument @var{left} specifies the width in pixels of the left -- 2.39.2