RE: doc on define-minor-mode hook variable(s)

[Drew Adams]

    > exiting the mode. What's not clear from this doc is whether
    > `define-minor-mode' creates a variable named `MODE-hook'.

    Here is the explanation: a hook is not a *variable* but a *symbol*.
    A hook has various elements, all of which happen to be
    currently stored in the value part of the symbol (some in the
    buffer-local parts, others in the global part).

    So whether or not a variable is created is not really relevant:
    the symbol is "created" and that's all that's needed.

    PS: Yes, this means that the only way to figure out whether a
    hook exists or not is by actually placing something on it and
    checking whether/when it gets triggered.  That's how hooks have
    been defined.

OK, thanks for the clarification.

I don't see how that substantially alters my point (or even most of what I
wrote): more should be said about the hook _symbol_ `MODE-hook' in the doc.
Users should be informed how they can take advantage of this feature.

My concern is not really whether or not these hooks exist. My concern is
that they are provided for by `define-minor-mode' but the behavior related
to them is not sufficiently documented. IOW, important functionality
provided by `define-minor-mode' is not revealed by the doc.