RE: lispref/hooks.texi

[Drew Adams]

> > The idea behind this appendix, I think, is that if someone 
> > is not sure which hook to put a function onto, it's good
> > to have a list of possible hooks to use.
> 
> Right, I can imagine it to be convenient when you're looking 
> around for window-configuration-change-hook, post-command-hook,
> and things along these lines, where the set of possible hooks
> is not related to a single chapter.

(So far, I have no opinion about whether the appendix is a good idea.  Note,
though, that there is some information there besides the list of hooks.  That
info could be moved to node `Hooks' if the appendix is removed.)

I would just point out that any particular hooks mentioned in a manual are
presumably indexed there, so `i' and `Info-apropos' should help readers find the
principal chapters that discuss them.  And `C-s' should help them find any
additional occurrences.

If part of your point is that it can be helpful to know about hooks that are not
mentioned in a manual, then `apropos-variable' should help with that.

Wouldn't `C-u apropos-variable -\(hooks?\|functions\)$ RET' list the (loaded or
autoloaded) normal and abnormal hooks?  If so, maybe just mention that somewhere
in the manual (e.g. `(emacs) Hooks' or `(elisp) Hooks'), instead of trying to
list hooks in the manual explicitly?

Finally, a comment about having an appendix that lists only some of the hooks -
e.g., removing "`blink-paren-function', `diary-*-hook'" etc. as Yidong
suggested:

In that case, we should no longer say that these are the "standard hook
variables".  We should be clear that the list is limited to a selection of hooks
"related to general Emacs editing".  And we should probably rename the node from
`Standard Hooks' to `Common Editing Hooks' or some such.