From: Lute Kamstra Date: Mon, 6 Oct 2003 08:26:59 +0000 (+0000) Subject: (Coding Conventions): Mention naming conventions for hooks. X-Git-Tag: ttn-vms-21-2-B4~8613 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=492475213fc13fc7a01ba53a3e6056e614ca315f;p=emacs.git (Coding Conventions): Mention naming conventions for hooks. --- diff --git a/lispref/ChangeLog b/lispref/ChangeLog index 70f4c732e25..089d1b698b1 100644 --- a/lispref/ChangeLog +++ b/lispref/ChangeLog @@ -1,3 +1,8 @@ +2003-10-06 Lute Kamstra + + * tips.texi (Coding Conventions): Mention naming conventions for + hooks. + 2003-10-05 Luc Teirlinck * 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 +2003-10-03 Lute Kamstra * 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 +2003-09-29 Lute Kamstra * 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 +2003-09-26 Lute Kamstra * 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 +2003-09-08 Lute Kamstra * modes.texi (%-Constructs): Document new `%i' and `%I' constructs. diff --git a/lispref/tips.texi b/lispref/tips.texi index d769fca581d..d07fa1b3712 100644 --- 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