[Emacs-diffs] master dd210a6: Obsolete sc-load-hook in favor of eval-after-load

[Glenn Morris]

branch: master
commit dd210a63dfdb1b021c8a6b5f29c8e6b0d428d5a2
Author: Glenn Morris <address@hidden>
Commit: Glenn Morris <address@hidden>

    Obsolete sc-load-hook in favor of eval-after-load
    
    * lisp/mail/supercite.el (sc-load-hook): Make obsolete.
    * doc/misc/sc.texi (Getting Connected, Filling Cited Text):
    No longer mention sc-load-hook.
---
 doc/misc/sc.texi       |   17 ++---------------
 lisp/mail/supercite.el |    3 +++
 2 files changed, 5 insertions(+), 15 deletions(-)

diff --git a/doc/misc/sc.texi b/doc/misc/sc.texi
index 1f7b73d..8051229 100644
--- a/doc/misc/sc.texi
+++ b/doc/misc/sc.texi
@@ -775,18 +775,6 @@ MUA calls @code{sc-cite-original} at the right time.  As 
mentioned
 above, some MUAs handle this differently.  Read the sections that follow
 pertaining to the MUAs you are using.
 
address@hidden sc-load-hook
address@hidden load-hook (sc-)
address@hidden sc-pre-hook
address@hidden pre-hook (sc-)
-One final note.  After Supercite is loaded into your Emacs session, it
-runs the hook @code{sc-load-hook}.  You can put any customizations into
-this hook since it is only run once.  This will not work, however, if
-your Emacs maintainer has put Supercite into your dumped Emacs image.
-In that case, you can use the @code{sc-pre-hook} variable, but this will
-get executed every time @code{sc-cite-original} is called.  @xref{Reply
-Buffer Initialization}.
-
 @node  Replying and Yanking
 @chapter Replying and Yanking
 
@@ -964,8 +952,6 @@ reset certain variables set in @code{sc-pre-hook}.
 @cindex gin-mode
 @findex sc-setup-filladapt
 @findex setup-filladapt (sc-)
address@hidden sc-load-hook
address@hidden load-hook (sc-)
 
 Supercite will automatically fill newly cited text from the original
 message unless the variable @code{sc-auto-fill-region-p} has a
@@ -979,7 +965,8 @@ two best known are @dfn{filladapt} and @dfn{gin-mode}.  
Both work well
 with Supercite and both are available at the normal Emacs Lisp archive
 sites.  @dfn{gin-mode} works pretty well out of the box, but if you use
 @dfn{filladapt}, you may want to run the function
address@hidden from your @code{sc-load-hook}.  This simply
address@hidden after loading @file{supercite}
+(e.g., using @code{with-eval-after-load}).  This simply
 makes @dfn{filladapt} a little more Supercite savvy than its default
 setup.
 
diff --git a/lisp/mail/supercite.el b/lisp/mail/supercite.el
index 3d4ccf9..b38b16f 100644
--- a/lisp/mail/supercite.el
+++ b/lisp/mail/supercite.el
@@ -302,6 +302,9 @@ during the initial citing via `sc-cite-original'."
   "Hook which gets run once after Supercite loads."
   :type 'hook
   :group 'supercite-hooks)
+(make-obsolete-variable 'sc-load-hook
+                        "use `with-eval-after-load' instead." "26.1")
+
 (defcustom sc-pre-hook nil
   "Hook which gets run before each invocation of `sc-cite-original'."
   :type 'hook