lispref/hooks.texi patch.

[Lute Kamstra]

I've updated the Standard Hooks node of the Elisp manual.  Shall I
commit it?

Lute


Index: lispref/ChangeLog
===================================================================
RCS file: /cvsroot/emacs/emacs/lispref/ChangeLog,v
retrieving revision 1.340
diff -u -r1.340 ChangeLog
--- lispref/ChangeLog   1 Apr 2005 00:30:03 -0000       1.340
+++ lispref/ChangeLog   1 Apr 2005 10:53:43 -0000
@@ -1,3 +1,9 @@
+2005-04-01  Lute Kamstra  <address@hidden>
+
+       * hooks.texi (Standard Hooks): Add some hooks.  Add cross
+       references and/or descriptions.  Delete major mode hooks; mention
+       them as a category instead.  Rename or delete obsolete hooks.
+
 2005-04-01  Kenichi Handa  <address@hidden>
 
        * nonascii.texi (Coding System Basics): Describe about rondtrip
Index: lispref/hooks.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/lispref/hooks.texi,v
retrieving revision 1.18
diff -u -r1.18 hooks.texi
--- lispref/hooks.texi  25 Sep 2004 02:43:35 -0000      1.18
+++ lispref/hooks.texi  1 Apr 2005 10:53:43 -0000
@@ -1,6 +1,6 @@
 @c -*-texinfo-*-
 @c This is part of the GNU Emacs Lisp Reference Manual.
address@hidden Copyright (C) 1990, 1991, 1992, 1993, 1998, 2004 Free Software 
Foundation, Inc.
address@hidden Copyright (C) 1990, 1991, 1992, 1993, 1998, 2004, 2005 Free 
Software Foundation, Inc.
 @c See the file elisp.texi for copying conditions.
 @setfilename ../info/hooks
 @node Standard Hooks, Index, Standard Keymaps, Top
@@ -16,6 +16,11 @@
 to put a new function on such a hook is to call @code{add-hook}.
 @xref{Hooks}, for more information about using hooks.
 
+Every major mode defines a mode hook named
address@hidden@var{modename}-mode-hook}.  The major mode command runs this
+normal hook with @code{run-mode-hooks} as the very last thing it does.
address@hidden Hooks}.  Mode hooks are omitted in the list below.
+
 The variables whose names end in @samp{-hooks} or @samp{-functions} are
 usually @dfn{abnormal hooks}; their values are lists of functions, but
 these functions are called in a special way (they are passed arguments,
@@ -28,118 +33,229 @@
 names ending in @samp{-hook} even though they were not normal hooks;
 however, we have renamed all of those.)
 
address@hidden !!! need  xref  to where each hook is documented or else 
document it
address@hidden by specifying what is expected, and when it is called relative to
address@hidden mode initialization.
address@hidden We need to xref to where each hook is documented or else document
address@hidden it here.
 
 @table @code
 @item activate-mark-hook
address@hidden Mark}.
+
 @item after-change-functions
address@hidden Hooks}.
+
 @item after-change-major-mode-hook
address@hidden Hooks}.
+
 @item after-init-hook
address@hidden File}.
+
 @item after-insert-file-functions
address@hidden Properties}.
+
 @item after-make-frame-functions
address@hidden Frames}.
+
 @item after-revert-hook
address@hidden
+
 @item after-save-hook
address@hidden apropos-mode-hook
address@hidden Buffers}.
+
 @item auto-fill-function
address@hidden Filling}.
+
 @item auto-save-hook
address@hidden
+
 @item before-change-functions
address@hidden Hooks}.
+
 @item before-init-hook
address@hidden File}.
+
 @item before-make-frame-hook
address@hidden Frames}.
+
 @item before-revert-hook
address@hidden
+
 @item before-save-hook
address@hidden Buffers}.
+
 @item blink-paren-function
address@hidden
+
 @item buffer-access-fontify-functions
address@hidden c-mode-hook
address@hidden Properties}.
+
 @item calendar-load-hook
address@hidden Customizing,, emacs-xtra}.
+
 @item change-major-mode-hook
address@hidden command-history-hook
address@hidden Buffer-Local}.
+
 @item command-line-functions
address@hidden Arguments}.
+
 @item comment-indent-function
address@hidden for Comments,, Options Controlling Comments, emacs, the
+GNU Emacs Manual}.
+
 @item custom-define-hook
+Hook called after defining each customize option.
+
 @item deactivate-mark-hook
address@hidden Mark}.
+
 @item desktop-after-read-hook
+Normal hook run after a successful @code{desktop-read}.  May e.g. be
+used to show a buffer list.  @xref{Saving Emacs Sessions,, Saving
+Emacs Sessions, emacs, the GNU Emacs Manual}.
+
 @item desktop-no-desktop-file-hook
+Normal hook run when @code{desktop-read} can't find a desktop file.
+May e.g. be used to show a dired buffer.  @xref{Saving Emacs
+Sessions,, Saving Emacs Sessions, emacs, the GNU Emacs Manual}.
+
 @item desktop-save-hook
+Normal hook run before the desktop is saved in a desktop file.  This
+is useful for truncating history lists, for example.  @xref{Saving
+Emacs Sessions,, Saving Emacs Sessions, emacs, the GNU Emacs Manual}.
+
 @item diary-display-hook
address@hidden Diary Display,, emacs-xtra}.
+
 @item diary-hook
address@hidden dired-mode-hook
+List of functions called after the display of the diary.  Can be used
+for appointment notification.
+
 @item disabled-command-function
address@hidden Commands}.
+
 @item echo-area-clear-hook
address@hidden edit-picture-hook
address@hidden electric-buffer-menu-mode-hook
address@hidden electric-command-history-hook
address@hidden electric-help-mode-hook
address@hidden emacs-lisp-mode-hook
address@hidden Echo Area}.
+
address@hidden emacs-startup-hook
address@hidden File}.
+
 @item find-file-hook
address@hidden Functions}.
+
 @item find-file-not-found-functions
address@hidden Functions}.
+
 @item first-change-hook
address@hidden fortran-comment-hook
address@hidden fortran-mode-hook
address@hidden indent-mim-hook
address@hidden Hooks}.
+
 @item initial-calendar-window-hook
address@hidden Customizing,, emacs-xtra}.
+
 @item kbd-macro-termination-hook
address@hidden Macros}.
+
 @item kill-buffer-hook
address@hidden Buffers}.
+
 @item kill-buffer-query-functions
address@hidden Buffers}.
+
 @item kill-emacs-hook
address@hidden Emacs}.
+
 @item kill-emacs-query-functions
address@hidden LaTeX-mode-hook
address@hidden ledit-mode-hook
address@hidden Emacs}.
+
 @item lisp-indent-function
address@hidden lisp-interaction-mode-hook
address@hidden lisp-mode-hook
+
 @item list-diary-entries-hook
address@hidden mail-mode-hook
address@hidden Diary Display,, emacs-xtra}.
+
 @item mail-setup-hook
address@hidden Mode Misc,, Mail Mode Miscellany, emacs, the GNU Emacs
+Manual}.
+
 @item mark-diary-entries-hook
address@hidden medit-mode-hook
address@hidden Diary Display,, emacs-xtra}.
+
 @item menu-bar-update-hook
address@hidden Bar}.
+
 @item minibuffer-setup-hook
address@hidden Misc}.
+
 @item minibuffer-exit-hook
address@hidden Misc}.
+
 @item mouse-position-function
address@hidden news-mode-hook
address@hidden news-reply-mode-hook
address@hidden news-setup-hook
address@hidden Position}.
+
 @item nongregorian-diary-listing-hook
address@hidden/Islamic Entries,, emacs-xtra}.
+
 @item nongregorian-diary-marking-hook
address@hidden nroff-mode-hook
address@hidden outline-mode-hook
address@hidden plain-TeX-mode-hook
address@hidden/Islamic Entries,, emacs-xtra}.
+
 @item post-command-hook
address@hidden Overview}.
+
 @item pre-abbrev-expand-hook
address@hidden Expansion}.
+
 @item pre-command-hook
address@hidden Overview}.
+
 @item print-diary-entries-hook
address@hidden prolog-mode-hook
address@hidden protect-innocence-hook
address@hidden Customizing,, emacs-xtra}.
+
 @item redisplay-end-trigger-functions
address@hidden rmail-edit-mode-hook
address@hidden rmail-mode-hook
address@hidden rmail-summary-mode-hook
address@hidden scheme-indent-hook
address@hidden scheme-mode-hook
address@hidden scribe-mode-hook
address@hidden shell-mode-hook
address@hidden shell-set-directory-error-hook
address@hidden Hooks}.
+
address@hidden scheme-indent-function
+
 @item suspend-hook
address@hidden Emacs}.
+
 @item suspend-resume-hook
address@hidden Emacs}.
+
address@hidden temp-buffer-setup-hook
address@hidden Displays}.
+
 @item temp-buffer-show-function
address@hidden Displays}.
+
address@hidden temp-buffer-show-hook
address@hidden Displays}.
+
 @item term-setup-hook
address@hidden terminal-mode-hook
address@hidden terminal-mode-break-hook
address@hidden TeX-mode-hook
address@hidden text-mode-hook
address@hidden
+
 @item today-visible-calendar-hook
address@hidden Customizing,, emacs-xtra}.
+
 @item today-invisible-calendar-hook
address@hidden vi-mode-hook
address@hidden view-hook
address@hidden Customizing,, emacs-xtra}.
+
 @item window-configuration-change-hook
address@hidden Hooks}.
+
 @item window-scroll-functions
address@hidden Hooks}.
+
 @item window-setup-hook
address@hidden Systems}.
+
 @item window-size-change-functions
address@hidden Hooks}.
+
 @item write-contents-functions
address@hidden Buffers}.
+
 @item write-file-functions
address@hidden Buffers}.
+
 @item write-region-annotate-functions
address@hidden Properties}.
 @end table
 
 @ignore