[Emacs-diffs] /srv/bzr/emacs/trunk r107057: Document post-self-insert-hook

[Glenn Morris]

------------------------------------------------------------
revno: 107057
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Wed 2012-02-01 20:37:05 -0800
message:
  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.
modified:
  doc/lispref/ChangeLog
  doc/lispref/hooks.texi
  doc/lispref/modes.texi
  doc/lispref/text.texi
  etc/NEWS

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2012-02-02 04:28:15 +0000
+++ b/doc/lispref/ChangeLog     2012-02-02 04:37:05 +0000
@@ -1,6 +1,12 @@
 2012-02-02  Glenn Morris  <address@hidden>
 
        * 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  <address@hidden>
 
-       * hooks.texi (Standard Hooks): Add prog-mode-hook.
-
        * modes.texi (Defining Minor Modes):
        Document define-minor-mode's new :variable keyword.
 

=== modified file 'doc/lispref/hooks.texi'
--- a/doc/lispref/hooks.texi    2012-02-02 04:28:15 +0000
+++ b/doc/lispref/hooks.texi    2012-02-02 04:37:05 +0000
@@ -295,6 +295,9 @@
 @item post-command-hook
 @xref{Command Overview}.
 
address@hidden post-self-insert-hook
address@hidden and Minor Modes}.
+
 @item pre-command-hook
 @xref{Command Overview}.
 

=== modified file 'doc/lispref/modes.texi'
--- a/doc/lispref/modes.texi    2012-02-02 02:57:26 +0000
+++ b/doc/lispref/modes.texi    2012-02-02 04:37:05 +0000
@@ -1341,11 +1341,12 @@
 @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

=== modified file 'doc/lispref/text.texi'
--- a/doc/lispref/text.texi     2012-01-28 03:56:20 +0000
+++ b/doc/lispref/text.texi     2012-02-02 04:37:05 +0000
@@ -500,6 +500,11 @@
 responsible for calling @code{blink-paren-function} when the inserted
 character has close parenthesis syntax (@pxref{Blinking}).
 
address@hidden post-self-insert-hook
+The final thing this command does is to run the hook
address@hidden  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.

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2012-02-02 04:13:02 +0000
+++ b/etc/NEWS  2012-02-02 04:37:05 +0000
@@ -1271,6 +1271,7 @@
 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.
 
 +++