# HG changeset patch
# User Chong Yidong <cyd@stupidchicken.com>
# Date 1226939964 0
# Node ID da7dc901e0e6bedd61ef05a6a3b01946abe629cb
# Parent  b8704eb1a8e9491b9fa0aedc1e1faf2f20edc004
(Using Region): Document Delete Selection Mode more thoroughly.

diff -r b8704eb1a8e9 -r da7dc901e0e6 doc/emacs/mark.texi
--- a/doc/emacs/mark.texi	Mon Nov 17 16:39:17 2008 +0000
+++ b/doc/emacs/mark.texi	Mon Nov 17 16:39:24 2008 +0000
@@ -222,9 +222,6 @@
   Most commands that operate on the text in the region have the word
 @code{region} in their names.
 
-  If Delete Selection mode is enabled, some commands delete the region
-when used while the mark is active.  @xref{Mouse Commands}.
-
   Some commands have a default behavior when the region is inactive,
 but operate on the text in the region if the region is active.  For
 example, @kbd{M-$} (@code{ispell-word}) normally checks the spelling
@@ -235,6 +232,17 @@
 region, change the variable @code{use-empty-active-region} to
 @code{t}.
 
+@cindex Delete Selection mode
+@cindex mode, Delete Selection
+@findex delete-selection-mode
+  If you enable Delete Selection mode, a minor mode, then inserting
+text while the region is active causes the selected text to be deleted
+first.  This also deactivates the mark.  Many graphical applications
+follow this convention, but Emacs does not.  To toggle Delete
+Selection mode on or off, type @kbd{M-x delete-selection-mode}.
+Another effect of this mode is that some keys, such as @key{DEL} and
+@kbd{C-d}, always kill the region if one exists.
+
 @node Mark Ring
 @section The Mark Ring