From bd2589e4bea47e3ca94cfa5938f632bfa21bdb2c Mon Sep 17 00:00:00 2001 From: John Wiegley Date: Sun, 3 Dec 2017 23:33:22 -0800 Subject: [PATCH] Add notes to NEWS.md --- etc/USE-PACKAGE-NEWS | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/etc/USE-PACKAGE-NEWS b/etc/USE-PACKAGE-NEWS index eeaf91bdb0a..805272f43e1 100644 --- a/etc/USE-PACKAGE-NEWS +++ b/etc/USE-PACKAGE-NEWS @@ -12,7 +12,7 @@ ``` elisp (use-package diminish :ensure t) ``` - + - Emacs 24.3 or higher is now a requirement. - The `:defer-install` keyword has been remove. It may reappear as an add-on @@ -28,6 +28,14 @@ - Upgrade license to GPL 3. +- If `use-package-verbose` is set to the symbol `debug`, any evaluation errors + during package configuration will cause a complete report to be written to a + `*use-package*` buffer, including: the text of the error, the `use-package` + declaration that caused the error, the post-normalized form of this + declaration, and the macro-expanded version (without verbosity-related + code). Note that this still does not help if there are parsing errors, which + will still cause Emacs to encounter a Lisp error at startup time. + - New `:hook` keyword. - New keywords `:custom (foo1 bar1) (foo2 bar2)` etc., and `:custom-face`. @@ -58,6 +66,12 @@ - Documentation added for the `:after`, `:defer-install`, `:delight`, `:requires`, `:when` and `:unless` keywords. +- New undocumented (and currently experimental) keyword `:load` may be used to + change the name of the actual package loaded, rather than the package name, + and may even add other names. For example: `(use-package auctex :load + tex-site)`. This keyword is used internally to generate the `require` for a + package, so that deferral is simply a matter of not generating this keyword. + - The source code is now broken into several files, so that certain optional features (diminish, delight, ensure) may be maintained separately from the core functionality. @@ -69,4 +83,3 @@ - Append to *use-package* when debugging, don't clear it. - Don't allow :commands, :bind, etc., to be given an empty list. - Explicit :defer t should override use-package-always-demand. - -- 2.39.2