[Emacs-diffs] emacs/doc/lispref ChangeLog display.texi

[Chong Yidong]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Chong Yidong <cyd>      09/04/13 15:54:18

Modified files:
        doc/lispref    : ChangeLog display.texi 

Log message:
        * display.texi (Refresh Screen): Note that a passage about screen
        refreshing is text terminal only.
        (Forcing Redisplay): Delete misleading comment---sit-for calls
        redisplay, not the other way around.
        (Truncation): Note new values of truncate-partial-width-windows.
        Copyedits.
        (Invisible Text): Document invisible-p.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/lispref/ChangeLog?cvsroot=emacs&r1=1.258&r2=1.259
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/lispref/display.texi?cvsroot=emacs&r1=1.42&r2=1.43

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/emacs/emacs/doc/lispref/ChangeLog,v
retrieving revision 1.258
retrieving revision 1.259
diff -u -b -r1.258 -r1.259
--- ChangeLog   11 Apr 2009 08:54:44 -0000      1.258
+++ ChangeLog   13 Apr 2009 15:54:17 -0000      1.259
@@ -1,3 +1,13 @@
+2009-04-13  Chong Yidong  <address@hidden>
+
+       * display.texi (Refresh Screen): Note that a passage about screen
+       refreshing is text terminal only.
+       (Forcing Redisplay): Delete misleading comment---sit-for calls
+       redisplay, not the other way around.
+       (Truncation): Note new values of truncate-partial-width-windows.
+       Copyedits.
+       (Invisible Text): Document invisible-p.
+
 2009-04-11  Eli Zaretskii  <address@hidden>
 
        * display.texi (Overlays): Overlays don't scale well.  See

Index: display.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/lispref/display.texi,v
retrieving revision 1.42
retrieving revision 1.43
diff -u -b -r1.42 -r1.43
--- display.texi        11 Apr 2009 08:54:08 -0000      1.42
+++ display.texi        13 Apr 2009 15:54:17 -0000      1.43
@@ -60,11 +60,11 @@
 immediately, but the requested redisplay does happen
 eventually---after all the input has been processed.
 
-  Normally, suspending and resuming Emacs also refreshes the screen.
-Some terminal emulators record separate contents for display-oriented
-programs such as Emacs and for ordinary sequential display.  If you are
-using such a terminal, you might want to inhibit the redisplay on
-resumption.
+  On text-only terminals, suspending and resuming Emacs normally also
+refreshes the screen.  Some terminal emulators record separate
+contents for display-oriented programs such as Emacs and for ordinary
+sequential display.  If you are using such a terminal, you might want
+to inhibit the redisplay on resumption.
 
 @defvar no-redraw-on-reenter
 @cindex suspend (cf. @code{no-redraw-on-reenter})
@@ -79,13 +79,13 @@
 @cindex forcing redisplay
 
   Emacs normally tries to redisplay the screen whenever it waits for
-input.  With this function you can request an immediate attempt to
-redisplay, in the middle of Lisp code, without actually waiting for
-input.
+input.  With the following function, you can request an immediate
+attempt to redisplay, in the middle of Lisp code, without actually
+waiting for input.
 
 @defun redisplay &optional force
 This function tries immediately to redisplay, provided there are no
-pending input events.  It is equivalent to @code{(sit-for 0)}.
+pending input events.
 
 If the optional argument @var{force} is address@hidden, it does all
 pending redisplay work even if input is available, with no
@@ -166,14 +166,12 @@
 for this; @pxref{Display Tables}).
 
 @defopt truncate-lines
-This buffer-local variable controls how Emacs displays lines that extend
-beyond the right edge of the window.  The default is @code{nil}, which
-specifies continuation.  If the value is address@hidden, then these
-lines are truncated.
-
-If the variable @code{truncate-partial-width-windows} is address@hidden,
-then truncation is always used for side-by-side windows (within one
-frame) regardless of the value of @code{truncate-lines}.
+If this buffer-local variable is address@hidden, lines that extend
+beyond the right edge of the window are truncated; otherwise, they are
+continued.  As a special exception, the variable
address@hidden takes precedence in
address@hidden windows (i.e., windows that do not occupy the
+entire frame width).
 @end defopt
 
 @defopt default-truncate-lines
@@ -182,42 +180,50 @@
 @end defopt
 
 @defopt truncate-partial-width-windows
-This variable controls display of lines that extend beyond the right
-edge of the window, in side-by-side windows (@pxref{Splitting Windows}).
-If it is address@hidden, these lines are truncated; otherwise,
address@hidden says what to do with them.
+This variable controls line truncation in @dfn{partial-width} windows.
+A partial-width window is one that does not occupy the entire frame
+width (@pxref{Splitting Windows}).  If the value is @code{nil}, line
+truncation is determined by the variable @code{truncate-lines} (see
+above).  If the value is an integer @var{n}, lines are truncated if
+the partial-width window has fewer than @var{n} columns, regardless of
+the value of @code{truncate-lines}; if the partial-width window has
address@hidden or more columns, line truncation is determined by
address@hidden  For any other address@hidden value, lines are
+truncated in every partial-width window, regardless of the value of
address@hidden
 @end defopt
 
   When horizontal scrolling (@pxref{Horizontal Scrolling}) is in use in
 a window, that forces truncation.
 
 @defvar wrap-prefix
-If this buffer-local variable is address@hidden, the prefix it defines
-will be added at display-time to the beginning of every continuation
-line due to text wrapping (so if lines are truncated, the wrap-prefix
-is never used).  It may be a string, an image, or a stretch-glyph such
-as used by the `display' text-property.  @xref{Display Property}.
-
-A wrap-prefix may also be specified for regions of text using the
address@hidden text-property (which takes precedence over the
-value of the @code{wrap-prefix} variable).  @xref{Special Properties}.
+If this buffer-local variable is address@hidden, it defines a
+``prefix'' that is added at display-time to the beginning of every
+continuation line.  (If lines are truncated, the wrap-prefix is never
+used.)  It may be a string, an image, or a stretch-glyph, as used by
+the @code{display} text property.  @xref{Display Property}.
+
+A wrap-prefix may also be specified for regions of text, using the
address@hidden text property.  This takes precedence over the
+value of the @code{wrap-prefix} variable.  @xref{Special Properties}.
 @end defvar
 
 @defvar line-prefix
-If this buffer-local variable is address@hidden, the prefix it defines
-will be added at display-time to the beginning of every
-non-continuation line It may be a string, an image, or a stretch-glyph
-such as used by the `display' text-property.  @xref{Display Property}.
+If this buffer-local variable is address@hidden, it defines a
+``prefix'' that is added at display-time to the beginning of every
+non-continuation line.  It may be a string, an image, or a
+stretch-glyph, as used by the @code{display} text property.
address@hidden Property}.
 
 A line-prefix may also be specified for regions of text using the
address@hidden text-property (which takes precedence over the
-value of the @code{line-prefix} variable).  @xref{Special Properties}.
address@hidden text property.  This takes precedence over the
+value of the @code{line-prefix} variable.  @xref{Special Properties}.
 @end defvar
 
   If your buffer contains @emph{very} long lines, and you use
-continuation to display them, just thinking about them can make Emacs
-redisplay slow.  The column computation and indentation functions also
-become slow.  Then you might find it advisable to set
+continuation to display them, computing the continuation lines can
+make Emacs redisplay slow.  The column computation and indentation
+functions also become slow.  Then you might find it advisable to set
 @code{cache-long-line-scans} to @code{t}.
 
 @defvar cache-long-line-scans
@@ -846,12 +852,25 @@
 (remove-from-invisibility-spec 'my-symbol)
 @end example
 
+  You can check for invisibility using the following function:
+
address@hidden invisible-p pos-or-prop
+If @var{pos-or-prop} is a marker or number, this function returns a
address@hidden value if the text at that position is invisible.
+
+If @var{pos-or-prop} is any other kind of Lisp object, that is taken
+to mean a possible value of the @code{invisible} text or overlay
+property.  In that case, this function returns a address@hidden value
+if that value would cause text to become invisible, based on the
+current value of @code{buffer-invisibility-spec}.
address@hidden defun
+
 @vindex line-move-ignore-invisible
   Ordinarily, functions that operate on text or move point do not care
 whether the text is invisible.  The user-level line motion commands
-explicitly ignore invisible newlines if
address@hidden is address@hidden (the default), but
-only because they are explicitly programmed to do so.
+ignore invisible newlines if @code{line-move-ignore-invisible} is
address@hidden (the default), but only because they are explicitly
+programmed to do so.
 
   However, if a command ends with point inside or immediately before
 invisible text, the main editing loop moves point further forward or