*** empty log message ***

4 files changed, 64 insertions, 7 deletions

diff --git a/lispref/anti.texi b/lispref/anti.texi
index b038cb42fba..0950af3d3f4 100644
--- a/lispref/anti.texi
+++ b/lispref/anti.texi
@@ -16,6 +16,7 @@ the following section, we carry this information back to Emacs
 @itemize @bullet
 @item
 The @code{push} and @code{pop} macros are not defined.
+Neither are @code{dolist} and @code{dotimes}.
 
 @item
 You can't display images in buffers.  (Emacs is meant for editing text.)
@@ -57,10 +58,26 @@ text cursor, and the mouse cursor.  To specify menu colors, use X
 resources.
 
 @item
+Colors and other face attributes are no longer supported on character
+terminals, so you no longer have to worry about terminals making faces
+at you.
+
+@item
 Emacs will respect your peace and quiet, aside from occasional beeps,
 because there are no facilities for playing sounds.
 
 @item
+Emacs 20 provides a complex and badly designed method for handling
+character composition for languages such as Thai that display several
+letters as a single combined image.  We are too ashamed of it to tell
+you any more than that.
+
+@item
+@code{delete-and-extract-region} has been deleted; instead, use
+@code{buffer-substring} to extract the text, then use
+@code{delete-region} to delete it.
+
+@item
 Regular expressions do not support the POSIX character classes
 such as @samp{[:alpha:]}.  All characters are created equal.
 
@@ -85,6 +102,14 @@ For simplicity, all @sc{ascii} characters now have the same height and width.
 the standard width.)  All characters are created equal.
 
 @item
+You can now resize any Emacs window, and size changes in one window can
+propagate to all others.  Windows can no longer use
+@code{window-size-fixed} to get special privileges.
+
+@item
+The function @code{intern-soft} no longer accepts a symbol as argument.
+
+@item
 The function @code{bitmap-spec-p} has been renamed to
 @code{pixmap-spec-p} to encourage users to practice Emacs' help system
 while trying to find it.
@@ -111,6 +136,10 @@ The functions @code{format} and @code{message} ignore and discard text
 properties.
 
 @item
+The function @code{propertize} does not exist;
+you can get the job done using @code{set-text-properties}.
+
+@item
 Colors are supported only on window systems, not on text-only terminals.
 So the support functions for colors on text-only terminals are
 not needed, and have been eliminated.
diff --git a/lispref/display.texi b/lispref/display.texi
index 005ac907e0e..5baee30ebb0 100644
--- a/lispref/display.texi
+++ b/lispref/display.texi
@@ -1785,8 +1785,10 @@ family, a font pattern is constructed.
 and character's registry and encoding.  If there is a font that matches
 exactly, it is used, of course.  The hard case is when no available font
 exactly fits the specification.  Then Emacs looks for one that is
-``close''---one attribute at a time.  You can specify the order
-to consider the attributes.
+``close''---one attribute at a time.  You can specify the order to
+consider the attributes.  In the case where a specified font family is
+not available, you can specify a set of mappings for alternatives to
+try.
 
 @defvar face-font-selection-order
 @tindex face-font-selection-order
diff --git a/lispref/frames.texi b/lispref/frames.texi
index 57a61b68b8a..35dfb6dd312 100644
--- a/lispref/frames.texi
+++ b/lispref/frames.texi
@@ -1614,6 +1614,13 @@ once.  This is true for displays that use a window system such as X, and
 false for text-only terminals.
 @end defun
 
+@defun display-mouse-p &optional display
+@tindex display-mouse-p
+@cindex mouse, availability
+This function returns @code{t} if @var{display} has a mouse available,
+@code{nil} if not.
+@end defun
+
 @defun display-color-p &optional display
 @tindex display-color-p
 @findex x-display-color-p
@@ -1625,6 +1632,7 @@ is still supported as an alias.
 @defun display-grayscale-p &optional display
 @tindex display-grayscale-p
 This function returns @code{t} if the screen can display shades of gray.
+(All color displays can do this.)
 @end defun
 
 @defun display-selections-p &optional display
@@ -1663,7 +1671,11 @@ or @code{nil} if Emacs cannot get that information.
 
 @defun display-backing-store &optional display
 @tindex display-backing-store
-This function returns the backing store capability of the screen.
+This function returns the backing store capability of the display.
+Backing store means recording the pixels of windows (and parts of
+windows) that are not exposed, so that when exposed they can be
+displayed very quickly.
+
 Values can be the symbols @code{always}, @code{when-mapped}, or
 @code{not-useful}.  The function can also return @code{nil}
 when the question is inapplicable to a certain kind of display.
@@ -1672,12 +1684,15 @@ when the question is inapplicable to a certain kind of display.
 @defun display-save-under &optional display
 @tindex display-save-under
 This function returns non-@code{nil} if the display supports the
-SaveUnder feature.
+SaveUnder feature.  That feature is used by pop-up windows
+to save the pixels they obscure, so that they can pop down
+quickly.
 @end defun
 
 @defun display-planes &optional display
 @tindex display-planes
 This function returns the number of planes the display supports.
+This is typically the number of bits per pixel.
 @end defun
 
 @defun display-visual-class &optional display
diff --git a/lispref/text.texi b/lispref/text.texi
index 1a8b12bbf5c..6c3e9722266 100644
--- a/lispref/text.texi
+++ b/lispref/text.texi
@@ -496,12 +496,23 @@ be compared with that of the former text.
 @end deffn
 
 @deffn Command delete-region start end
-This command deletes the text in the current buffer in the region
-defined by @var{start} and @var{end}.  The value is @code{nil}.  If
-point was inside the deleted region, its value afterward is @var{start}.
+This command deletes the text between positions @var{start} and
+@var{end} in the current buffer, and returns @code{nil}.  If point was
+inside the deleted region, its value afterward is @var{start}.
 Otherwise, point relocates with the surrounding text, as markers do.
 @end deffn
 
+@defun delete-and-extract-region start end
+@tindex delete-and-extract-region
+This function deletes the text between positions @var{start} and
+@var{end} in the current buffer, and returns a string containing the
+text just deleted.
+
+If point was inside the deleted region, its value afterward is
+@var{start}.  Otherwise, point relocates with the surrounding text, as
+markers do.
+@end defun
+
 @deffn Command delete-char count &optional killp
 This command deletes @var{count} characters directly after point, or
 before point if @var{count} is negative.  If @var{killp} is