From: Stefan Kangas <stefankangas@gmail.com>
Date: Fri, 9 Dec 2022 04:12:03 +0000 (+0100)
Subject: Clarify :after keyword in use-package docstring
X-Git-Tag: emacs-29.0.90~1299
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=0b3116971afc5cb76cd2745bef1c12405d79528f;p=emacs.git

Clarify :after keyword in use-package docstring

* lisp/use-package/use-package-core.el (use-package): Clarify the
effect of :after in docstring.

Resolves https://github.com/jwiegley/use-package/issues/825
---

diff --git a/lisp/use-package/use-package-core.el b/lisp/use-package/use-package-core.el
index 868a65803a4..1c61ac0ed39 100644
--- a/lisp/use-package/use-package-core.el
+++ b/lisp/use-package/use-package-core.el
@@ -1647,12 +1647,15 @@ this file.  Usage:
                  `:magic-fallback', or `:interpreter'.  This can be an integer,
                  to force loading after N seconds of idle time, if the package
                  has not already been loaded.
-:after           Delay the use-package declaration until after the named modules
-                 have loaded. Once load, it will be as though the use-package
-                 declaration (without `:after') had been seen at that moment.
 :demand          Prevent the automatic deferred loading introduced by constructs
                  such as `:bind' (see `:defer' for the complete list).
 
+:after           Delay the effect of the use-package declaration
+                 until after the named libraries have loaded.
+                 Before they have been loaded, no other keyword
+                 has any effect at all, and once they have been
+                 loaded it is as if `:after' was not specified.
+
 :if EXPR         Initialize and load only if EXPR evaluates to a non-nil value.
 :disabled        The package is ignored completely if this keyword is present.
 :defines         Declare certain variables to silence the byte-compiler.