diff lispref/text.texi @ 27654:cabb1b4c4424

*** empty log message ***

--- a/lispref/text.texi	Wed Feb 09 20:37:57 2000 +0000
+++ b/lispref/text.texi	Wed Feb 09 23:54:58 2000 +0000
@@ -496,12 +496,23 @@
 @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