* doc/emacs/regs.texi (File Registers): Document `kmacro-to-register'.

4 files changed, 31 insertions, 8 deletions

diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index c8a9054e7c8..5c66a2a6ea6 100644
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -1,5 +1,7 @@
 2013-12-22  Xue Fuqiao  <xfq.free@gmail.com>
 
+        * regs.texi (File Registers): Document `kmacro-to-register'.
+
         * indent.texi (Tab Stops): Mention recent changes about `tab-stop-list'.
 
         * frames.texi (Scroll Bars): Document `scroll-bar-adjust-thumb-portion'.
diff --git a/doc/emacs/emacs.texi b/doc/emacs/emacs.texi
index 9eb7db9ee82..4845d49b823 100644
--- a/doc/emacs/emacs.texi
+++ b/doc/emacs/emacs.texi
@@ -345,13 +345,14 @@ Yanking
 
 Registers
 
-* Position Registers::      Saving positions in registers.
-* Text Registers::          Saving text in registers.
-* Rectangle Registers::     Saving rectangles in registers.
-* Configuration Registers:: Saving window configurations in registers.
-* Number Registers::        Numbers in registers.
-* File Registers::          File names in registers.
-* Bookmarks::               Bookmarks are like registers, but persistent.
+* Position Registers::       Saving positions in registers.
+* Text Registers::           Saving text in registers.
+* Rectangle Registers::      Saving rectangles in registers.
+* Configuration Registers::  Saving window configurations in registers.
+* Number Registers::         Numbers in registers.
+* File Registers::           File names in registers.
+* Keyboard Macro Registers:: Keyboard macros in registers.
+* Bookmarks::                Bookmarks are like registers, but persistent.
 
 Controlling the Display
 
diff --git a/doc/emacs/regs.texi b/doc/emacs/regs.texi
index 77545dff5b2..bc6bcb3799f 100644
--- a/doc/emacs/regs.texi
+++ b/doc/emacs/regs.texi
@@ -41,6 +41,7 @@ this chapter.
 * Configuration Registers::  Saving window configurations in registers.
 * Number Registers::         Numbers in registers.
 * File Registers::           File names in registers.
+* Keyboard Macro Registers:: Keyboard macros in registers.
 * Bookmarks::                Bookmarks are like registers, but persistent.
 @end menu
 
@@ -251,6 +252,23 @@ puts the file name shown in register @samp{z}.
 @var{r}}.  (This is the same command used to jump to a position or
 restore a frame configuration.)
 
+@node Keyboard Macro Registers
+@section Keyboard Macro Registers
+@cindex saving keyboard macro in a register
+@cindex keyboard macros, in registers
+
+@kindex C-x C-k x
+@findex kmacro-to-register
+  If you execute certain keyboard macros (@pxref{Keyboard Macros})
+frequently, you can execute them more conveniently if putting them in
+registers or save them (@pxref{Save Keyboard Macro}).  @kbd{C-x C-k x
+@var{r}} (@code{kmacro-to-register}) stores the last keyboard macro in
+register @var{r}.
+
+  To execute the keyboard macro in register @var{r}, type @kbd{C-x r j
+@var{r}}.  (This is the same command used to jump to a position or
+restore a frameset.)
+
 @node Bookmarks
 @section Bookmarks
 @cindex bookmarks
diff --git a/etc/NEWS b/etc/NEWS
index 05005721e28..100eb873137 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -260,7 +260,9 @@ bidirectional context.
 
 *** All register commands can now show help with preview.
 
-*** New command `kmacro-to-register' stores keyboard macros in registers.
++++
+*** New command `C-x C-k x' (`kmacro-to-register') stores keyboard
+macros in registers.
 
 *** New command `C-x r f' (`frameset-to-register').
 See Changes in Emacs 24.4, above.