Re: unload-feature questions and thoughts

[David Kastrup <dak@gnu.org>]

"Juanma Barranquero" <lekktu@gmail.com> writes:

> On 2/5/07, David Kastrup <dak@gnu.org> wrote:
>
>> Could you think of something in code or docs that should have
>> prevented the confusion?
>
> I misread the code (I was much more centered in the part about undoing
> defun, provide, etc. and didn't take a closer look to the beginning of
> the function), but I think this piece of docstring is a bit confusing
>
>  This function tries to undo modifications made by the package to
>  hooks.  Packages may define a hook FEATURE-unload-hook that is called
>  instead of the normal heuristics for doing this.  Such a hook should
>  undo all the relevant global state changes that may have been made by
>  loading the package or executing functions in it.
>
> because if you miss the "to hooks" (two words), as I did in several
> readings, it seems like it is saying that either you define
> FEATURE-unload-hook, or else it uses "the normal heuristics".

Maybe "the normal heuristics" and "all the relevant global state
changes" are far too much hand-waving: readers will probably
phantasize whatever they would think useful into it.

-- 
David Kastrup