Improve documentation of `special' modes.

[gnu-emacs] / doc / lispref / hooks.texi

diff --git a/doc/lispref/hooks.texi b/doc/lispref/hooks.texi
index 8eb5bcb241c82c6118f8f013ecff858ae9744f2a..6e2cac9c06571d9ad2dba6e9b659b95364b95698 100644 (file)
--- a/doc/lispref/hooks.texi
+++ b/doc/lispref/hooks.texi
@@ -1,7 +1,6 @@
 @c -*-texinfo-*-
 @c This is part of the GNU Emacs Lisp Reference Manual.
-@c Copyright (C) 1990, 1991, 1992, 1993, 1998, 2001, 2002, 2003, 2004,
-@c   2005, 2006, 2007, 2008, 2009  Free Software Foundation, Inc.
+@c Copyright (C) 1990-1993, 1998, 2001-2011  Free Software Foundation, Inc.
 @c See the file elisp.texi for copying conditions.
 @setfilename ../../info/hooks
 @node Standard Hooks, Index, Standard Keymaps, Top
@@ -96,6 +95,14 @@ not exactly a hook, but does a similar job.
 @item buffer-access-fontify-functions
 @xref{Lazy Properties}.
 
+@item calendar-initial-window-hook
+@iftex
+@inforef{Calendar Customizing,, emacs-xtra}.
+@end iftex
+@ifnottex
+@xref{Calendar Customizing,,, emacs}.
+@end ifnottex
+
 @item calendar-load-hook
 @iftex
 @inforef{Calendar Customizing,, emacs-xtra}.
@@ -104,6 +111,21 @@ not exactly a hook, but does a similar job.
 @xref{Calendar Customizing,,, emacs}.
 @end ifnottex
 
+@item calendar-today-invisible-hook
+@iftex
+@inforef{Calendar Customizing,, emacs-xtra}.
+@end iftex
+@ifnottex
+@xref{Calendar Customizing,,, emacs}.
+@end ifnottex
+
+@item calendar-today-visible-hook
+@iftex
+@inforef{Calendar Customizing,, emacs-xtra}.
+@end iftex
+@ifnottex
+@xref{Calendar Customizing,,, emacs}.
+@end ifnottex
 
 @item change-major-mode-hook
 @xref{Creating Buffer-Local}.
@@ -146,7 +168,11 @@ 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
+@item diary-hook
+List of functions called after the display of the diary.  Can be used
+for appointment notification.
+
+@item diary-list-entries-hook
 @iftex
 @inforef{Fancy Diary Display,, emacs-xtra}.
 @end iftex
@@ -154,9 +180,37 @@ Emacs Sessions,, Saving Emacs Sessions, emacs, the GNU Emacs Manual}.
 @xref{Fancy Diary Display,,, emacs}.
 @end ifnottex
 
-@item diary-hook
-List of functions called after the display of the diary.  Can be used
-for appointment notification.
+@item diary-mark-entries-hook
+@iftex
+@inforef{Fancy Diary Display,, emacs-xtra}.
+@end iftex
+@ifnottex
+@xref{Fancy Diary Display,,, emacs}.
+@end ifnottex
+
+@item diary-nongregorian-listing-hook
+@iftex
+@inforef{Non-Gregorian Diary,, emacs-xtra}.
+@end iftex
+@ifnottex
+@xref{Non-Gregorian Diary,,, emacs}.
+@end ifnottex
+
+@item diary-nongregorian-marking-hook
+@iftex
+@inforef{Non-Gregorian Diary,, emacs-xtra}.
+@end iftex
+@ifnottex
+@xref{Non-Gregorian Diary,,, emacs}.
+@end ifnottex
+
+@item diary-print-entries-hook
+@iftex
+@inforef{Diary Display,, emacs-xtra}.
+@end iftex
+@ifnottex
+@xref{Diary Display,,, emacs}.
+@end ifnottex
 
 @item disabled-command-function
 @xref{Disabling Commands}.
@@ -200,14 +254,6 @@ for appointment notification.
 @item font-lock-unfontify-region-function
 @xref{Other Font Lock Variables}.
 
-@item initial-calendar-window-hook
-@iftex
-@inforef{Calendar Customizing,, emacs-xtra}.
-@end iftex
-@ifnottex
-@xref{Calendar Customizing,,, emacs}.
-@end ifnottex
-
 @item kbd-macro-termination-hook
 @xref{Keyboard Macros}.
 
@@ -225,26 +271,10 @@ for appointment notification.
 
 @item lisp-indent-function
 
-@item list-diary-entries-hook
-@iftex
-@inforef{Fancy Diary Display,, emacs-xtra}.
-@end iftex
-@ifnottex
-@xref{Fancy Diary Display,,, emacs}.
-@end ifnottex
-
 @item mail-setup-hook
 @xref{Mail Mode Misc,, Mail Mode Miscellany, emacs, the GNU Emacs
 Manual}.
 
-@item mark-diary-entries-hook
-@iftex
-@inforef{Fancy Diary Display,, emacs-xtra}.
-@end iftex
-@ifnottex
-@xref{Fancy Diary Display,,, emacs}.
-@end ifnottex
-
 @item menu-bar-update-hook
 @xref{Menu Bar}.
 
@@ -257,22 +287,6 @@ Manual}.
 @item mouse-position-function
 @xref{Mouse Position}.
 
-@item nongregorian-diary-listing-hook
-@iftex
-@inforef{Non-Gregorian Diary,, emacs-xtra}.
-@end iftex
-@ifnottex
-@xref{Non-Gregorian Diary,,, emacs}.
-@end ifnottex
-
-@item nongregorian-diary-marking-hook
-@iftex
-@inforef{Non-Gregorian Diary,, emacs-xtra}.
-@end iftex
-@ifnottex
-@xref{Non-Gregorian Diary,,, emacs}.
-@end ifnottex
-
 @item occur-hook
 
 @item post-command-hook
@@ -281,14 +295,6 @@ Manual}.
 @item pre-command-hook
 @xref{Command Overview}.
 
-@item print-diary-entries-hook
-@iftex
-@inforef{Diary Customizing,, emacs-xtra}.
-@end iftex
-@ifnottex
-@xref{Diary Customizing,,, emacs}.
-@end ifnottex
-
 @item resume-tty-functions
 @xref{Suspending Emacs}.
 
@@ -315,22 +321,6 @@ Manual}.
 @item term-setup-hook
 @xref{Terminal-Specific}.
 
-@item today-visible-calendar-hook
-@iftex
-@inforef{Calendar Customizing,, emacs-xtra}.
-@end iftex
-@ifnottex
-@xref{Calendar Customizing,,, emacs}.
-@end ifnottex
-
-@item today-invisible-calendar-hook
-@iftex
-@inforef{Calendar Customizing,, emacs-xtra}.
-@end iftex
-@ifnottex
-@xref{Calendar Customizing,,, emacs}.
-@end ifnottex
-
 @item window-configuration-change-hook
 @xref{Window Hooks}.
 
@@ -352,7 +342,3 @@ Manual}.
 @item write-region-annotate-functions
 @xref{Format Conversion}.
 @end table
-
-@ignore
-   arch-tag: 55fd0296-d906-4551-b300-979d3846aa88
-@end ignore