From: Glenn Morris <rgm@gnu.org>
Date: Sun, 4 Dec 2016 03:27:41 +0000 (-0800)
Subject: Obsolete sc-load-hook in favor of eval-after-load
X-Git-Tag: emacs-26.0.90~1211
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=dd210a63dfdb1b021c8a6b5f29c8e6b0d428d5a2;p=emacs.git

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.
---

diff --git a/doc/misc/sc.texi b/doc/misc/sc.texi
index 1f7b73dd73b..80512292c32 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.
 
-@vindex sc-load-hook
-@vindex load-hook (sc-)
-@vindex sc-pre-hook
-@vindex 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-)
-@vindex sc-load-hook
-@vindex 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
-@code{sc-setup-filladapt} from your @code{sc-load-hook}.  This simply
+@code{sc-setup-filladapt} 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 3d4ccf90e1b..b38b16f699d 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