(The Mark): Document use-region-p.

[gnu-emacs] / doc / lispref / display.texi

diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index be249d3a4d6f600ac93934f674eaf506cb53247c..a8e8e531e306781d404bb62d0293d6fb5562bb2e 100644 (file)
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -559,7 +559,7 @@ truncated to fit it, as in Emacs 20 and before.
   The variable @code{max-mini-window-height}, which specifies the
 maximum height for resizing minibuffer windows, also applies to the
 echo area (which is really a special use of the minibuffer window.
-@xref{Minibuffer Misc}.
+@xref{Minibuffer Misc}.).
 
 @node Warnings
 @section Reporting Warnings
@@ -1803,6 +1803,11 @@ kind of customization item (@pxref{Customization}) which the user can
 customize using the Customization buffer (@pxref{Easy Customization,,,
 emacs, The GNU Emacs Manual}).
 
+  People are sometimes tempted to create variables whose values specify
+which faces to use (for example, Font-Lock does this).  In the vast
+majority of cases, this is not necessary, and simply using faces
+directly is preferable.
+
 @defmac defface face spec doc [keyword value]@dots{}
 This declares @var{face} as a customizable face that defaults
 according to @var{spec}.  You should not quote the symbol @var{face},
@@ -2902,7 +2907,7 @@ If @var{name} is @code{nil}, this function modifies the 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
+@var{from} and @var{to} are character codepoints.  In that case, use
 @var{fontname} for all characters in the range @var{from} and @var{to}
 (inclusive).
 
@@ -3814,6 +3819,7 @@ displayed (@pxref{Display Feature Testing}).
 * XBM Images::          Special features for XBM format.
 * XPM Images::          Special features for XPM format.
 * GIF Images::          Special features for GIF format.
+* TIFF Images::         Special features for TIFF format.
 * PostScript Images::   Special features for PostScript format.
 * Other Image Types::   Various other formats are supported.
 * Defining Images::     Convenient ways to define an image for later use.
@@ -4199,6 +4205,20 @@ every 0.1 seconds.
     (run-with-timer 0.1 nil 'display-anim buffer file (1+ idx) max nil)))
 @end ignore
 
+@node TIFF Images
+@subsection TIFF Images
+@cindex TIFF
+
+  For TIFF images, specify image type @code{tiff}.
+
+@table @code
+@item :index @var{index}
+You can use @code{:index} to specify one image from a TIFF file that
+contains more than one image.  This property specifies use of image
+number @var{index} from the file.  If the TIFF file doesn't contain an
+image with index @var{index}, the image displays as a hollow box.
+@end table
+
 @node PostScript Images
 @subsection PostScript Images
 @cindex postscript images