Document post-self-insert-hook

* doc/lispref/hooks.texi (Standard Hooks):
* doc/lispref/modes.texi (Keymaps and Minor Modes):
* doc/lispref/text.texi (Commands for Insertion):
Document post-self-insert-hook.

*etc/NEWS: Markup.

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 92c46d0c8c521adba56ebc2659d1e715ecff8434..5765b151b41cac6ff4c39880fac43f11d9a099ca 100644 (file)
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,5 +1,11 @@
 2012-02-02  Glenn Morris  <rgm@gnu.org>
 
+       * hooks.texi (Standard Hooks):
+       * modes.texi (Keymaps and Minor Modes):
+       * text.texi (Commands for Insertion): Document post-self-insert-hook.
+
+       * hooks.texi (Standard Hooks): Add prog-mode-hook.
+
        * hooks.texi (Standard Hooks):
        * modes.texi (Major Mode Conventions, Mode Hooks):
        Document change-major-mode-after-body-hook.
@@ -18,8 +24,6 @@
 
 2012-01-31  Glenn Morris  <rgm@gnu.org>
 
-       * hooks.texi (Standard Hooks): Add prog-mode-hook.
-
        * modes.texi (Defining Minor Modes):
        Document define-minor-mode's new :variable keyword.
 

diff --git a/doc/lispref/hooks.texi b/doc/lispref/hooks.texi
index bf4afb4cf2c8711ad98460a1540f76a5d3acf3fc..ef3ebc4be3523df2605391d10a42f1b200776301 100644 (file)
--- a/doc/lispref/hooks.texi
+++ b/doc/lispref/hooks.texi
@@ -295,6 +295,9 @@ Manual}.
 @item post-command-hook
 @xref{Command Overview}.
 
+@item post-self-insert-hook
+@xref{Keymaps and Minor Modes}.
+
 @item pre-command-hook
 @xref{Command Overview}.
 

diff --git a/doc/lispref/modes.texi b/doc/lispref/modes.texi
index e142be44e0d7e77789b3ff8b52d0e4bc0486c02d..0eda905f82fecded25ca225ef3d45a23be7ea337 100644 (file)
--- a/doc/lispref/modes.texi
+++ b/doc/lispref/modes.texi
@@ -1341,11 +1341,12 @@ alist @code{minor-mode-map-alist}.  @xref{Definition of minor-mode-map-alist}.
 @cindex @code{self-insert-command}, minor modes
   One use of minor mode keymaps is to modify the behavior of certain
 self-inserting characters so that they do something else as well as
-self-insert.  In general, this is the only way to do that, since the
-facilities for customizing @code{self-insert-command} are limited to
-special cases (designed for abbrevs and Auto Fill mode).  (Do not try
-substituting your own definition of @code{self-insert-command} for the
-standard one.  The editor command loop handles this function specially.)
+self-insert.  (Another way to customize @code{self-insert-command} is
+through @code{post-self-insert-hook}.  Apart from this, the facilities
+for customizing @code{self-insert-command} are limited to special cases,
+designed for abbrevs and Auto Fill mode.  Do not try substituting your
+own definition of @code{self-insert-command} for the standard one.  The
+editor command loop handles this function specially.)
 
 The key sequences bound in a minor mode should consist of @kbd{C-c}
 followed by one of @kbd{.,/?`'"[]\|~!#$%^&*()-_+=}.  (The other

diff --git a/doc/lispref/text.texi b/doc/lispref/text.texi
index 55b0c0a4be87b3c2eb828b2a9b61aa6c17eb2d1d..448634ba5a74dd301a5e537aad2e2489dedacff9 100644 (file)
--- a/doc/lispref/text.texi
+++ b/doc/lispref/text.texi
@@ -500,6 +500,11 @@ syntax. (@xref{Abbrevs}, and @ref{Syntax Class Table}.)  It is also
 responsible for calling @code{blink-paren-function} when the inserted
 character has close parenthesis syntax (@pxref{Blinking}).
 
+@vindex post-self-insert-hook
+The final thing this command does is to run the hook
+@code{post-self-insert-hook}.  You could use this to automatically
+reindent text as it is typed, for example.
+
 Do not try substituting your own definition of
 @code{self-insert-command} for the standard one.  The editor command
 loop handles this function specially.

diff --git a/etc/NEWS b/etc/NEWS
index 67aee36461bcd3933a48b749427c56e9a6c85159..0299572ca583fdf1a1de7297d52155f46c538eea 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1271,6 +1271,7 @@ syntax-propertize-via-font-lock to reuse old font-lock-syntactic-keywords
 as-is; and syntax-propertize-rules which provides a new way to specify
 syntactic rules.
 
++++
 ** New hook post-self-insert-hook run at the end of self-insert-command.
 
 +++