[Emacs-diffs] Changes to emacs/lispref/Attic/loading.texi, v [EMACS_22_BASE]

[Richard M. Stallman]

CVSROOT:        /cvsroot/emacs
Module name:    emacs
Branch:         EMACS_22_BASE
Changes by:     Richard M. Stallman <rms>       07/10/24 08:17:47

Index: loading.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/lispref/Attic/loading.texi,v
retrieving revision 1.74
retrieving revision 1.74.2.1
diff -u -b -r1.74 -r1.74.2.1
--- loading.texi        7 Apr 2007 01:46:44 -0000       1.74
+++ loading.texi        24 Oct 2007 08:17:47 -0000      1.74.2.1
@@ -862,24 +862,27 @@
 It then restores any autoloads formerly associated with those symbols.
 (Loading saves these in the @code{autoload} property of the symbol.)
 
address@hidden unload-feature-special-hooks
 Before restoring the previous definitions, @code{unload-feature} runs
 @code{remove-hook} to remove functions in the library from certain
 hooks.  These hooks include variables whose names end in @samp{hook}
 or @samp{-hooks}, plus those listed in
address@hidden  This is to prevent Emacs from
-ceasing to function because important hooks refer to functions that
-are no longer defined.
address@hidden, as well as
address@hidden  This is to prevent Emacs from ceasing to
+function because important hooks refer to functions that are no longer
+defined.
+
+Standard unloading activities also undoes ELP profiling of functions
+in that library, unprovides any features provided by the library, and
+cancels timers held in variables defined by the library.
 
address@hidden @var{feature}-unload-hook
address@hidden @var{feature}-unload-function
 If these measures are not sufficient to prevent malfunction, a library
-can define an explicit unload hook.  If @address@hidden
-is defined, it is run as a normal hook before restoring the previous
-definitions, @emph{instead of} the usual hook-removing actions.  The
-unload hook ought to undo all the global state changes made by the
-library that might cease to work once the library is unloaded.
address@hidden can cause problems with libraries that fail to do
-this, so it should be used with caution.
+can define an explicit unloader named @address@hidden
+If that symbol is defined as a function, @code{unload-feature} calls
+it with no arguments before doing anything else.  It can do whatever
+is appropriate to unload the library.  If it returns @code{nil},
address@hidden proceeds to take the normal unload actions.
+Otherwise it considers the job to be done.
 
 Ordinarily, @code{unload-feature} refuses to unload a library on which
 other loaded libraries depend.  (A library @var{a} depends on library