(Coding Conventions): Mention naming conventions for hooks.

diff --git a/lispref/ChangeLog b/lispref/ChangeLog
index 70f4c732e25902bd539514448391b9183cfb31d1..089d1b698b142cc6cce4f59e59798ef37581456c 100644 (file)
--- a/lispref/ChangeLog
+++ b/lispref/ChangeLog
@@ -1,3 +1,8 @@
+2003-10-06  Lute Kamstra  <lute@gnu.org>
+
+       * tips.texi (Coding Conventions): Mention naming conventions for
+       hooks.
+
 2003-10-05  Luc Teirlinck  <teirllm@auburn.edu>
 
        * loading.texi (Library Search): Correct default value of
@@ -11,7 +16,7 @@
        (Unloading): In unload-feature, use new var name
        unload-feature-special-hooks.
 
-2003-10-03  Lute Kamstra  <Lute.Kamstra@cwi.nl>
+2003-10-03  Lute Kamstra  <lute@gnu.org>
 
        * modes.texi (Major Mode Conventions): Mention third way to set up
        Imenu.
@@ -28,14 +33,14 @@
 
        * display.texi (Overlay Properties): Clarify `evaporate' property.
 
-2003-09-29  Lute Kamstra  <Lute.Kamstra@cwi.nl>
+2003-09-29  Lute Kamstra  <lute@gnu.org>
 
        * modes.texi (Mode Line Data): Explain when symbols in mode-line
        constructs should be marked as risky.  
        Change cons cell into proper list.
        (Mode Line Variables): Change cons cell into proper list.
 
-2003-09-26  Lute Kamstra  <Lute.Kamstra@cwi.nl>
+2003-09-26  Lute Kamstra  <lute@gnu.org>
 
        * modes.texi (Mode Line Data): Document the :propertize construct.
        (Mode Line Variables): Reorder the descriptions of the variables
@@ -104,7 +109,7 @@
        * display.texi (Fontsets): Add char-displayable-p.
        (Scroll Bars): New node.
 
-2003-09-08  Lute Kamstra  <Lute.Kamstra@cwi.nl>
+2003-09-08  Lute Kamstra  <lute@gnu.org>
 
        * modes.texi (%-Constructs): Document new `%i' and `%I'
        constructs.

diff --git a/lispref/tips.texi b/lispref/tips.texi
index d769fca581d316437383befff3f6d333d30eaed7..d07fa1b3712a8c15e328e00d44902e0ef70903d7 100644 (file)
--- a/lispref/tips.texi
+++ b/lispref/tips.texi
@@ -125,6 +125,12 @@ add @samp{-p}.  Examples are @code{framep} and @code{frame-live-p}.
 If a user option variable records a true-or-false condition, give it a
 name that ends in @samp{-flag}.
 
+@item
+If the purpose of a variable is to store a single function, give it a
+name that ends in @samp{-function}.  If the purpose of a variable is
+to store a list of functions (i.e., the variable is a hook), please
+follow the naming conventions for hooks.  @xref{Hooks}.
+
 @item
 @cindex reserved keys
 @cindex keys, reserved