[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#21440: 25.0.50; Manual: FEATURE-unload-hook in (info "(elisp) Coding
From: |
Lars Ingebrigtsen |
Subject: |
bug#21440: 25.0.50; Manual: FEATURE-unload-hook in (info "(elisp) Coding Conventions") |
Date: |
Mon, 12 Jul 2021 14:05:13 +0200 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) |
Eli Zaretskii <eliz@gnu.org> writes:
>> At least now (docstring of `unload-feature'):
>>
>> | If a function `FEATURE-unload-function' is defined, this function
>> | calls it with no arguments, before doing anything else. That function
>> | can do whatever is appropriate to undo the loading of the library. If
>> | `FEATURE-unload-function' returns non-nil, that suppresses the
>> | standard unloading of the library. Otherwise the standard unloading
>> | proceeds.
>>
>> So it can now be controlled whether standard unloading stuff will still
>> be performed (last problem mentioned in my report -> solved).
Ah, right.
>> This questionable paragraph is sill in the manual however:
>>
>> • If loading the file adds functions to hooks, define a function
>> ‘FEATURE-unload-function’, where FEATURE is the name of the feature
>> the package provides, and make it undo any such changes. Using
>> ‘unload-feature’ to unload the file will run this function. *Note
>> Unloading::.
>>
>> I guess it is a bit outdated and this had been automated long ago,
>> although partially heuristically.
>
> I don't understand why you say this is outdated. What did I miss?
>
>> Instead it could say what typical non-standard changes need to be
>> handled in an unload-function.
>
> Isn't that what it says?
Well, it recommends writing an unload function, although this is rarely
necessary. So it should say something about when it's necessary.
--
(domestic pets only, the antidote for overdose, milk.)
bloggy blog: http://lars.ingebrigtsen.no
- bug#21440: 25.0.50; Manual: FEATURE-unload-hook in (info "(elisp) Coding Conventions"), Lars Ingebrigtsen, 2021/07/08
- bug#21440: 25.0.50; Manual: FEATURE-unload-hook in (info "(elisp) Coding Conventions"), Michael Heerdegen, 2021/07/11
- bug#21440: 25.0.50; Manual: FEATURE-unload-hook in (info "(elisp) Coding Conventions"), Eli Zaretskii, 2021/07/12
- bug#21440: 25.0.50; Manual: FEATURE-unload-hook in (info "(elisp) Coding Conventions"),
Lars Ingebrigtsen <=
- bug#21440: 25.0.50; Manual: FEATURE-unload-hook in (info "(elisp) Coding Conventions"), Michael Heerdegen, 2021/07/15
- bug#21440: 25.0.50; Manual: FEATURE-unload-hook in (info "(elisp) Coding Conventions"), Lars Ingebrigtsen, 2021/07/16
- bug#21440: 25.0.50; Manual: FEATURE-unload-hook in (info "(elisp) Coding Conventions"), Michael Heerdegen, 2021/07/16
- bug#21440: 25.0.50; Manual: FEATURE-unload-hook in (info "(elisp) Coding Conventions"), Michael Heerdegen, 2021/07/16
- bug#21440: 25.0.50; Manual: FEATURE-unload-hook in (info "(elisp) Coding Conventions"), Lars Ingebrigtsen, 2021/07/17
- bug#21440: 25.0.50; Manual: FEATURE-unload-hook in (info "(elisp) Coding Conventions"), Michael Heerdegen, 2021/07/20