Document `rectangle-mark-mode'.

* doc/emacs/mark.texi (Mark):
* doc/emacs/killing.texi (Rectangles): Document `rectangle-mark-mode'.

* etc/NEWS: Related edit.

diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index a99ff76ccb5eb50768de8ebb5e766655acb40317..2269349401c1bce45f0bbe45c1e0c79e2fb60fc9 100644 (file)
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -1,3 +1,8 @@
+2014-03-02  Xue Fuqiao  <xfq@gnu.org>
+
+       * mark.texi (Mark):
+       * killing.texi (Rectangles): Document `rectangle-mark-mode'.
+
 2014-03-01  Glenn Morris  <rgm@gnu.org>
 
        * search.texi (Query Replace): Mention search-invisible.

diff --git a/doc/emacs/killing.texi b/doc/emacs/killing.texi
index 1826c668aa5f7bab391fe9384ec5510aca3e9fa0..48d7f93396b2e0c0adfa940910dbf1131d8a0a2b 100644 (file)
--- a/doc/emacs/killing.texi
+++ b/doc/emacs/killing.texi
@@ -839,6 +839,13 @@ rectangle shifts right.
 @code{string-rectangle}, but inserts the string on each line,
 shifting the original text to the right.
 
+@findex rectangle-mark-mode
+@cindex rectangular region
+  The command @kbd{C-x SPC} (@code{rectangle-mark-mode}) makes a
+@dfn{rectangular region}.  It is a new feature introduced in GNU Emacs
+24.4, and most commands now are still unaware of it, but kill and yank
+(@pxref{Killing}) do work on the rectangle.
+
 @node CUA Bindings
 @section CUA Bindings
 @findex cua-mode

diff --git a/doc/emacs/mark.texi b/doc/emacs/mark.texi
index 7c3a9a43811b5b7483afe0bd724bdb90a70d6844..2f7ea3b4e9b955ee6eeac8b4e6ca22359d9e20bd 100644 (file)
--- a/doc/emacs/mark.texi
+++ b/doc/emacs/mark.texi
@@ -43,6 +43,9 @@ Ordinarily, only the selected window highlights its region; however,
 if the variable @code{highlight-nonselected-windows} is
 non-@code{nil}, each window highlights its own region.
 
+  There is another kind of region: the ``rectangular region''.
+@xref{Rectangles}.
+
 @menu
 * Setting Mark::            Commands to set the mark.
 * Marking Objects::         Commands to put region around textual units.

diff --git a/etc/NEWS b/etc/NEWS
index 1eb9a703ff9efe19cf97d739695f3d967520450f..ce98be2dda2c475b6e19652a4ba5ef64ef9daa87 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -371,6 +371,7 @@ conventions.  To use it, add it to the `fill-nobreak-predicate' hook.
 +++
 ** Uniquify is enabled by default, with `post-forward-angle-brackets' style.
 
++++
 ** New command `C-x SPC' (`rectangle-mark-mode') makes a rectangular region.
 Most commands are still unaware of it, but kill/yank do work on the rectangle.