From 0b3116971afc5cb76cd2745bef1c12405d79528f Mon Sep 17 00:00:00 2001 From: Stefan Kangas Date: Fri, 9 Dec 2022 05:12:03 +0100 Subject: [PATCH] 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 --- lisp/use-package/use-package-core.el | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) 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. -- 2.39.2