Allow :bind ("C-c C-c" . (lambda () (ding))) and #'(lambda ...)

Fixes https://github.com/jwiegley/use-package/issues/333
Fixes https://github.com/jwiegley/use-package/issues/461

Reorder some items in NEWS.md

Add NEWS.md file

Merge pull request from basil-conto/version

Require Emacs version >= 24.3
GitHub-reference: https://github.com/jwiegley/use-package/issues/519

Require Emacs version >= 24.3

Re: https://github.com/jwiegley/use-package/issues/457

Merge pull request from basil-conto/520

Require cl-lib and do not use seq functions
GitHub-reference: https://github.com/jwiegley/use-package/issues/521

Merge branch 'master' into 520

Add a missing (require 'seq)

Require cl-lib and do not use seq functions

cl-lib is also required for a separate call to cl-mapcan.

Fixes https://github.com/jwiegley/use-package/issues/520

When use-package-inject-hooks is non-nil, always fire init/config hooks

This used to not happen if `:init` or `:config` was missing, or set to nil as
with `:init nil`.

Fixes https://github.com/jwiegley/use-package/issues/250

Print map keys in describe-personal-keybindings

Fixes https://github.com/jwiegley/use-package/issues/406

Repeating a bind no longer causes duplicates in personal-keybindings

Fixes https://github.com/jwiegley/use-package/issues/446

When byte-compiling, correctly output declare-function directives

Fixes https://github.com/jwiegley/use-package/issues/474

Make diminish a soft dependency, as delight already was

Fixes https://github.com/jwiegley/use-package/issues/493

Allow :diminish to take no argument, once again

Fix for single :custom (foo bar)

Allow :custom (foo1 bar1) (foo2 bar2) etc

Fixes https://github.com/jwiegley/use-package/issues/518

Add support for `:hook`

Fixes https://github.com/jwiegley/use-package/issues/444

Append to *use-package* when debugging, don't clear it

Fixes https://github.com/jwiegley/use-package/issues/476

Make unrecognized keywords a warning

This could actually be used to store your own metadata in use-package
declarations, to be (read) later by simply parsing init file contents.

Fixes https://github.com/jwiegley/use-package/issues/483

Upgrade license to GPL 3

Fixes https://github.com/jwiegley/use-package/issues/499

Don't allow :commands, :bind, etc., to be given an empty list

This makes the following an error:

    :commands
    :commands nil
    :commands ()

Fixes https://github.com/jwiegley/use-package/issues/512

Explicit :defer t should override use-package-always-demand

Fixes https://github.com/jwiegley/use-package/issues/514

Merge pull request from drrlvn/patch-1

Remove duplicate documentation of :mode
GitHub-reference: https://github.com/jwiegley/use-package/issues/489

Corrections to the normalization of :custom

Merge pull request from joewreschnig/implicit-diminish

Allow `:diminish` with no arguments.
GitHub-reference: https://github.com/jwiegley/use-package/issues/472

Merge pull request from waymondo/master

Allow customized values to be nil
GitHub-reference: https://github.com/jwiegley/use-package/issues/515

allow customized values to be nil

Merge pull request from canatella/add-customization-keywords

Add customization keywords
GitHub-reference: https://github.com/jwiegley/use-package/issues/508

Add support for face customization

Allows customization of faces using customize-set-faces. This makes it
easier to manage customization in version control. Instead of having all the
faces written in a custom.el, the faces can be customized where the rest
of the package is configured.

Add support for variable customization

Allows customization of variable using customize-set-variables. This makes it
easier to manage customization in version control. Instead of having all the
variables written in a custom.el, the variable can be customized where the rest
of the package is configured.

Merge pull request from carldotac/master

Fix documentation typos
GitHub-reference: https://github.com/jwiegley/use-package/issues/513

Fix typos in docstring

Merge pull request from emacsjanitors/demote-manually

Don't use with-demoted-errors in use-package-ensure-elpa
GitHub-reference: https://github.com/jwiegley/use-package/issues/507

Cosmetic changes to use-package-ensure-elpa

Don't use with-demoted-errors in use-package-ensure-elpa

It expects a literal string as argument at macro-expansion
time, but we need to construct the message.

Merge pull request from raxod502/feat/fix-install-deferred

Fix bug in use-package-install-deferred-package
GitHub-reference: https://github.com/jwiegley/use-package/issues/479

Remove duplicate documentation of :mode

Merge pull request from joewreschnig/481-delight-docs

Document :delight in the doc string and README.
GitHub-reference: https://github.com/jwiegley/use-package/issues/484

Document :delight in the doc string and README

Allow `:diminish` with no arguments

When given no arguments, have :diminish assume it should diminish a
mode named after the current package (the package’s name, with “-mode”
appended, if it’s not already) to an empty string.

When given only a string to diminish an implicit package name to, do
not append “-mode” to the package name if it already ends with
it.  (This is a backwards-incompatible change if someone was
diminishing a package named “foo-mode” implementing `foo-mode-mode`.)

Add test cases for `use-package-normalize-diminish`.

This addresses some of the redundancy mentioned in issue https://github.com/jwiegley/use-package/issues/288.

Merge pull request from joewreschnig/477-delight-wrappers

Allow multiple :delight arguments, or omitting the mode. (https://github.com/jwiegley/use-package/issues/477)
GitHub-reference: https://github.com/jwiegley/use-package/issues/480

Allow :major as the third argument in :delight calls

Allow multiple :delight arguments, or omitting the mode. ()

This allows using forms such as

    (use-package foo :delight)
        ;; => (delight 'foo-mode)
    (use-package foo :delight " f")
        ;; => (delight 'foo-mode " f")
    (use-package foo :delight (a-mode) (b-mode " b")
        ;; => (delight 'a-mode) (delight 'b-mode " b")

This brings support for `:delight` in line with `:diminish`.
GitHub-reference: https://github.com/jwiegley/use-package/issues/477

Fix bug in use-package-install-deferred-package

Previously, deferred installation didn't work because I didn't convert
the result of a `completing-read' back from a string to a symbol,
which meant the hash-table lookup failed.

Merge pull request from joewreschnig/magic-469

Add `:magic` and `:magic-fallback` keywords (issue https://github.com/jwiegley/use-package/issues/469).
GitHub-reference: https://github.com/jwiegley/use-package/issues/473

Add `:magic` and `:magic-fallback` keywords (issue)

These keywords work equivalently to `:mode` or `:interpreter`, but for
`magic-mode-alist` and `magic-fallback-mode-alist`.

The handler function implementation is now passed a list to add to,
and shared by all four of them.
GitHub-reference: https://github.com/jwiegley/use-package/issues/469

Protect against errors during package install

If the network is missing and there is a new use-package with :ensure,
startup would fail part of the way through due package.el being unable
to reach the package repo.  This will catch that error and report it
while allowing startup to continue.

Copyright-paperwork-exempt: yes

Merge pull request from raxod502/feat/failed-autoload-msg

Fix quoting error in failed autoload message
GitHub-reference: https://github.com/jwiegley/use-package/issues/456

Fix quoting error in failed autoload message

Merge pull request from raxod502/normalize-nil

Make use-package-normalize-value handle nil better
GitHub-reference: https://github.com/jwiegley/use-package/issues/449

Make use-package-normalize-value handle nil better

The previous version of `use-package-normalize-value', when passed
nil, would return the list (symbol-value (quote nil)). This meant that
keywords which used `use-package-normalize-value' or the higher-level
normalizer `use-package-normalize-test' would get a non-nil
argument (i.e. the above list) even when the user specified nil to the
package.

This had the concrete impact of making it so that :defer-install nil
was treated as :defer-install t.

Merge pull request from raxod502/fix-bind-key-filter

Don't mutilate keyword arguments in :bind
GitHub-reference: https://github.com/jwiegley/use-package/issues/447

Add comment explaining keyword-argument patch

Don't mutilate keyword arguments in :bind

The parsing logic in `use-package-normalize-pairs' is not designed to
deal with keyword arguments. However, `use-package-normalize-pairs' is
used to process the arguments to :bind, which can include keyword
arguments. These keyword arguments are supposed to be passed untouched
to the underlying `bind-keys' function, but there is a clause in
`use-package-normalize-pairs' that replaces lists with their first
element. Thus an invocation like:

(use-package company
  :bind (:map company-active-map
         :filter (company-explicit-action-p)
         ("RET" . company-complete-selection)))

Generates code like this:

(bind-keys
  :map company-active-map
  :filter company-explicit-action-p
  ("RET" . company-complete-selection))

Which generates an error since `company-explicit-action-p' is now
being referenced as a variable rather than a function.

The proper solution is to refactor the logic that goes into parsing
uses of :bind, but this commit adds a temporary patch to eliminate the
above problem, while trying to be as reverse-compatible as possible.
In particular it just inhibits the list-to-first-element
transformation when the previous element processed was a keyword.

Merge pull request from raxod502/fix-after

Fix :after keyword
GitHub-reference: https://github.com/jwiegley/use-package/issues/439

Merge pull request from raxod502/always-defer-install

Add use-package-always-defer-install
GitHub-reference: https://github.com/jwiegley/use-package/issues/443

Add use-package-always-defer-install

See https://github.com/jwiegley/use-package/pull/433#issuecomment-289317875

Fix :after keyword

Commit [1] broke the functionality of :after (see [2]) due to an
extraneous quote being added.

[1]: bd2afa53c7580d23ed8008267b80e1834b6e6600
[2]: https://github.com/jwiegley/use-package/pull/433#issuecomment-287606553

Merge pull request from raxod502/defer-install

[RFC] Support for deferred installation
GitHub-reference: https://github.com/jwiegley/use-package/issues/433

Merge remote-tracking branch 'origin/master' into defer-install

Resolve merge conflicts.

Update docstring, installation prompt message

Various improvements for deferred installation

Get :defer-install completely working, in theory

* A quoting error has been fixed in `use-package-handler/:defer'.
* `use-package-install-deferred-package' has been updated to return t
  if the package was actually installed, and nil otherwise.
* The fake autoloads generated during deferred installation are
  doctored so Emacs does not think they were defined in the user's
  init-file.
* The docstrings of the fake autoloads have been improved.
* Arguments and interactivity are now correctly passed to the
  autoloaded function.
* The autoload now skips requiring the feature and calling the
  original function if the user declines to install the package. This
  prevents unprofessional errors.

Improve deferred installation mechanism

This time around, I've gotten rid of the advice on `require' (that was
never going to work) and instead made `use-package' try to handle
loading the package at the appropriate time. In particular, when
deferred installation is active, all the autoloads generated by
`use-package' are not regular autoloads, but regular functions that
will install the relevant package, require the relevant feature, and
only then call the newly defined (autoloaded) function.

Some smarter logic has been added to make sure things like `:demand'
play nicely with the autoloading system; see the extensive comment in
`use-package-handler/:defer-install' for more information on how that
works.

There was a section in `use-package-install-deferred-package' which
referred to a nonexistent variable `use-package--deferred-features';
that has been removed.

There is now, in addition to `use-package-ensure-function', a new
variable called `use-package-pre-ensure-function'. This is intended
for use by package managers which, unlike package.el, activate
autoloads package-by-package instead of all at once. Even if a package
is marked for deferred installation, the user would likely want its
autoloads activated immediately *if* it was already installed. The
logic for doing that can now be put in
`use-package-pre-ensure-function'.

Merge branch 'generalized-ensure' into defer-install

Update docstring for use-package-ensure-function

Now it properly reflects the API changes recently made.

First cut at :defer-install keyword

This new keyword, if provided along with a non-nil value, causes the
action of :ensure to be deferred until "necessary". Package
installation can be triggered by the user calling the new interactive
function `use-package-install-deferred-package', or by the feature
declared by the `use-package' form being required. This latter
behavior seems to be the simplest way to make sure that package
installation actually takes place when it needs to, but it requires
that an advice be added to `require', which may be considered overly
intrusive. (Also, it's generally considered bad practice for functions
in Emacs to put advice on other functions in Emacs.) Thus it may make
sense to add an option or function to explicitly enable this behavior,
if there does not turn out to be a better way to accomplish deferred
installation.

Documentation has not been updated to reflect :defer-install yet.

Extend capabilities of use-package-ensure-function

Modify the expected API of `use-package-ensure-function' so that it is
passed three arguments: the name of the package declared in the
`use-package' form; the argument passed to `:ensure'; and the current
`state' plist created by previous handlers. (Previously, it was only
given a single argument, which was the argument passed to `:ensure',
or the name of the package declared in the `use-package' form, if the
former was `t'.

This allows for more flexibility in the capabilities of the
`use-package-ensure-function' implementation. For example, its
behavior can change depending on the values of other keywords, if
those keywords modify the `state' plist appropriately.

Revert "Return `t' after calling `eval-after-load'"

This reverts commit 87a8ff6d693f3cc79ea423ca8c8e0a60b0bc596c.

Support multiple symbols passed to :after

The following expressions are now permitted:

    foo                         ; load after foo is loaded
    foo bar                     ; load after both foo and bar are loaded
    :all foo bar                ; same as previous
    :any foo bar                ; load after either foo or bar is loaded
    :any (:all foo bar) baz     ; more complex combinations...
    :any (:all foo bar) (:all baz wow)
    :all (:any foo bar) (:any baz wow)

Fixes https://github.com/jwiegley/use-package/issues/283

:mode and :interpreter can now accept (rx ...) forms

Fixes https://github.com/jwiegley/use-package/issues/204

Return `t' after calling `eval-after-load'

Fixes https://github.com/jwiegley/use-package/issues/174

Add autoload cookie for use-package-autoload-keymap

Fixes https://github.com/jwiegley/use-package/issues/337

Merge remote-tracking branch 'origin/pr/349'

Merge pull request from justbur/find-form

Add function use-package-jump-to-package-form
GitHub-reference: https://github.com/jwiegley/use-package/issues/359

Merge pull request from justbur/imenu3

Improve imenu support
GitHub-reference: https://github.com/jwiegley/use-package/issues/356

Merge pull request from raxod502/fix-use-package-defaults

Fix use-package-defaults
GitHub-reference: https://github.com/jwiegley/use-package/issues/430

Fix use-package-defaults

This patch should address issues https://github.com/jwiegley/use-package/issues/428 and https://github.com/jwiegley/use-package/issues/429. See https://github.com/jwiegley/use-package/issues/426 for
discussion. In brief, the issue was that use-package-sort-keywords was
not applied when the predicates in use-package-defaults did not return
true, when it should have been applied unconditionally.

Unrevert "Add use-package-defaults"

This reverts commit 013425edeb1829f5d21514f77d41763347538b14.

Revert "Add use-package-defaults"

This reverts commit 3dec23c0860ad297436b9b71b221491ae3790cce.

Merge pull request from raxod502/use-package-defaults

Add use-package-defaults
GitHub-reference: https://github.com/jwiegley/use-package/issues/426

Add use-package-defaults

Previously, the :config, :ensure, and :pin keywords had default
values (dependent on the values of the use-package-always-ensure and
use-package-always-pin). This change allows the user to customize the
default values used for those keywords, and add default values for
their own keywords in a non-hacky way.

This functionality would be useful for (as an example) the
quelpa-use-package package, which needs to use an advice to override
the functionality of :ensure. The same problem prevents adding a
use-package-always-quelpa variable in any reasonable way, without a
way to customize the default values of keywords.

Merge pull request from raxod502/use-package-ensure-function

Add use-package-ensure-function
GitHub-reference: https://github.com/jwiegley/use-package/issues/427

Add use-package-ensure-function

This allows the user to customize the :ensure keyword by using a
different package manager than package.el.

Add new customization option `use-package-always-demand`

This is equivalent to adding `:demand t` to all `use-package` declarations,
and has the same semantics as doing so (meaning it can be overridden locally
using `:defer t` in a declaration).

Fixes https://github.com/jwiegley/use-package/issues/423

Merge pull request from basil-conto/preface

Increase :preface priority
GitHub-reference: https://github.com/jwiegley/use-package/issues/418

Merge pull request from tarsius/outline

Support outline-minor-mode
GitHub-reference: https://github.com/jwiegley/use-package/issues/420

Merge pull request from tarsius/bind-later

Delay decision whether to use eval-after-load until run-time
GitHub-reference: https://github.com/jwiegley/use-package/issues/419

Delay decision whether to use eval-after-load until run-time

Just because a keymap variable is bound at macro-expansion-time
doesn't mean that it must be bound at run-time too.

Change `bind-keys-form', which is used by `bind-keys' and other
macros, to return a form which delays the decision on whether to
wrap the binding forms with `eval-after-load' until run-time.

Fixes https://github.com/jwiegley/use-package/issues/378.

Support outline-minor-mode

In "use-package.el" prefix headings with ";;;" instead of just
";;".  In "bind-key.el" add the missing ";;; Code:" heading.
In both libraries set `outline-regexp' to an appropriate value.

Increase :preface priority

Reconcile order of `use-package-keywords' with the README
description of `:preface' as occurring before everything but
`:disabled'.

Merge pull request from phst/bug398

Declare package-read-all-archive-contents
GitHub-reference: https://github.com/jwiegley/use-package/issues/402

Declare package-read-all-archive-contents

Fixes https://github.com/jwiegley/use-package/issues/398

Remove tests, which don’t work

Fixes https://github.com/jwiegley/use-package/issues/399

Don't allow implicit package name arg for binders

It's unlikely that

    (use-package foopkg :bind "<some-key>")

intendes to bind <some-key> to 'foopkg command.

Don't allow nil as a mode function

This means (use-package foopkg :mode (".foo")) will add (".foo"
. foopkg) into auto-mode-alist instead of the broken (".foo" . nil),
this is more consistent with the behaviour of (use-package foopkg
:mode (".foo" ".bar")).

Refactor pair normalizers; add tests for them

This is not a pure refactoring, it also fixes a bug where
:bind ([keysym] . "string") would actually bind keysym to nil (i.e.,
unbind it).  It now binds to "string" as expected.

Remove obsolete mplist tests

The mplist functions were removed in the 2.0
refactoring (4ae584f3ff0e9bda05420ec3b8598e59374b0899).

Bump version to 2.3