From: John Wiegley <johnw@newartisans.com>
Date: Tue, 5 Dec 2017 00:36:40 +0000 (-0800)
Subject: Add note in NEWS.md about :after and autoloaded keybindings
X-Git-Tag: emacs-29.0.90~1306^2~15^2~147
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=2892c026f469706cfbb30bf737625902b2d3cdc2;p=emacs.git

Add note in NEWS.md about :after and autoloaded keybindings
---

diff --git a/etc/USE-PACKAGE-NEWS b/etc/USE-PACKAGE-NEWS
index 28f76b942ea..5873d699089 100644
--- a/etc/USE-PACKAGE-NEWS
+++ b/etc/USE-PACKAGE-NEWS
@@ -118,6 +118,24 @@
   features (diminish, delight, ensure) may be maintained separately from the
   core functionality.
 
+- When using the `:after` keyword, now even autoloadeds keybinding are
+  deferred until after that other package has loaded, in order to allow
+  convenient `:bind` to maps only present in that other package. Consider the
+  following:
+
+  ``` elisp
+  (use-package helm-descbinds
+    :load-path "site-lisp/helm-descbinds"
+    :after helm
+    :bind ("C-h b" . helm-descbinds)
+    :init
+    (fset 'describe-bindings 'helm-descbinds))
+  ```
+
+  The binding of `C-h b` here will not occur until helm is loaded; and after
+  it is loaded, `helm-descbinds` itself is not loaded until the user presses
+  `C-h b`.
+
 ### Bug fixes
 
 - Repeating a bind no longer causes duplicates in personal-keybindings.