Fix typo in use-package docstring

Merge pull request from minad/improved-unbind

GitHub-reference: https://github.com/jwiegley/use-package/issues/910

unbind-key: Ensure that keys are removed from the keymap

* The removal from the keymap is performed by bind-key--remove
* Use the same argument normalization as bind-key

bind-key: Use new symbols for kmapvar

Merge pull request from tzz/tzz/use-package-use-theme

Add use-package-use-theme and avoid missing theme errors
GitHub-reference: https://github.com/jwiegley/use-package/issues/907

Add use-package-use-theme and avoid missing theme errors

Merge pull request from kljohann/custom-use-single-let

Use a single let binding when expanding consecutive :custom forms
GitHub-reference: https://github.com/jwiegley/use-package/issues/906

Use a single let binding when expanding consecutive :custom forms

Copyright-paperwork-exempt: yes

Merge pull request from tzz/tzz/remove-use-package-from-custom-enabled-themes

Remove use-package theme from global list of custom-enabled-themes
GitHub-reference: https://github.com/jwiegley/use-package/issues/899

Remove use-package theme from global list of custom-enabled-themes

* eval-when-compile for cases where use-package is only required at
  compile time

* remove the 'use-package theme from custom-enabled-themes so e.g.
  (mapc #'disable-theme custom-enabled-themes)
  won't kill user settings.

Merge pull request from tzz/tzz/set-comment-and-synthetic-theme

GitHub-reference: https://github.com/jwiegley/use-package/issues/881

Create new "use-package" themse and use it for :custom with custom-theme-set-variables

set property theme-value to avoid saving variable

Revert "use-package-core.el: use the Emacs set-default function to avoid saving :custom vars twice"

This reverts commit 8c31c57106e2938d627bf4107627c003620d2dd5.

set saved-variable-comment from :custom

GitHub-reference: https://github.com/jwiegley/use-package/issues/861

Update version to 2.4.1

Merge pull request from wyuenho/patch-1

GitHub-reference: https://github.com/jwiegley/use-package/issues/846

Merge branch 'master' into patch-1

Merge pull request from tzz/custom-set-default

GitHub-reference: https://github.com/jwiegley/use-package/issues/855

Update the documentation for :custom as per

GitHub-reference: https://github.com/jwiegley/use-package/issues/850

Fix broken test due to

GitHub-reference: https://github.com/jwiegley/use-package/issues/850

better tests

add test for

GitHub-reference: https://github.com/jwiegley/use-package/issues/845

Support keymap symbol in bind-key

GitHub-reference: fix https://github.com/jwiegley/use-package/issues/845

Merge pull request from tzz/custom-set-default

use-package-core.el: use the Emacs set-default function to avoid saving :custom vars twice
GitHub-reference: https://github.com/jwiegley/use-package/issues/850

use-package-core.el: use the Emacs set-default function to avoid saving :custom vars twice

Merge pull request from jjlee/call-hooks-even-if-no-config

GitHub-reference: https://github.com/jwiegley/use-package/issues/840

Merge branch 'master' into call-hooks-even-if-no-config

Merge pull request from nahuel/patch-1

GitHub-reference: https://github.com/jwiegley/use-package/issues/843

typo, should be a vector, not a bytecode object

Solves https://github.com/jwiegley/use-package/issues/842

Add special value back again, in case needed for backwards compat

I don't know why this special value exists, but perhaps old client code uses it.

The additional `t' in the macro expansion is accidental but not harmful I guess.

Copyright-paperwork-exempt: yes

Even when there's no :config, run any pre/post config hooks

i.e., following the existing docs for use-package-inject-hooks, these hooks are
run:

use-package--foo--pre-config-hook
use-package--foo--post-config-hook

This should make config customisations more predictable (for example, spacemacs
uses these hooks extensively to allow 'layers' to be customised).

I got rid of the "special" default value for :config, because it doesn't seem to
be treated any differently than nil.

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

Copyright-paperwork-exempt: yes

Merge pull request from jwiegley/johnw/clarify

Clarify the documentation for :after
GitHub-reference: https://github.com/jwiegley/use-package/issues/820

Clarify the documentation for :after

Merge pull request from DamienCassou/typos

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

Fix typos

Typos found with codespell.

Merge pull request from tarsiiformes/typos

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

Fix typos

Use `require', not `load', when byte-compiling ()

Use `require', not `load', when byte-compiling
GitHub-reference: https://github.com/jwiegley/use-package/issues/783

Update tests

Switch from `require' to `load' + `featurep'

Use `require', not `load', when byte-compiling

Make custom-face evaluate elisp. ()

Make custom-face evaluate elisp.
GitHub-reference: https://github.com/jwiegley/use-package/issues/773

Make custom-face evaluate elisp

Fix https://github.com/jwiegley/use-package/issues/696.

Copyright-paperwork-exempt: yes

Merge pull request from stribb/master

Add a line of documentation for (use-pacakage ... :hook).
GitHub-reference: https://github.com/jwiegley/use-package/issues/759

Add a line of documentation for (use-pacakage ... :hook)

Copyright-paperwork-exempt: yes

Merge pull request from conao3/fix_default_value

fix gethash default value for use-package-statistics-time
GitHub-reference: https://github.com/jwiegley/use-package/issues/681

Merge pull request from tarsiiformes/silencio

Silence byte-compiler on Emacs 25
GitHub-reference: https://github.com/jwiegley/use-package/issues/733

Silence byte-compiler on Emacs 25

Emacs 25 defined a global variable `features', which triggers a
warning "Lexical argument shadows the dynamic variable features".
That's not `use-package's fault, but we should suppress the warning
anyway, so that there is no additional noise that would cause us to
potentially overlook warnings that absolutely have to be addressed.

Merge pull request from jwiegley/use-package-chords-suppress-compiler-message

prefix argument with _ to suppress Unused lexical argument warning
GitHub-reference: https://github.com/jwiegley/use-package/issues/713

Merge pull request from lrochfort/ensure-system-package_use-sudo

[Fix https://github.com/jwiegley/use-package/issues/720] Install system packages using system-packages-install
GitHub-reference: https://github.com/jwiegley/use-package/issues/721

[] Install system packages using system-packages-install

:ensure-system-package was installing packages by running
system-packages-get-command via async-shell-command. This meant that
system-packages-use-sudo wasn't being honoured.

This patch makes :ensure-system-package use system-packages-install
for all cases, except where a custom install command is supplied, in
which case async-shell-command is used.

This issue was introduced in 9f034a0bcfdd8c4 [https://github.com/jwiegley/use-package/issues/673], as a fix for
[https://github.com/jwiegley/use-package/issues/661]. Prior to that commit, system-packages-use-sudo was being
honoured.

This patch also fixes a bug where a cons containing a lone symbol in a
list of conses causes nil to used as the package to install.
GitHub-reference: fix https://github.com/jwiegley/use-package/issues/720
Copyright-paperwork-exempt: yes

prefix argument with _ to suppress Unused lexical argument warning

per @tarsius’s comment
https://github.com/jwiegley/use-package/commit/5d9c854a6cf12fff2326ee5653e87e2d3d550a8d#commitcomment-29996666

Merge pull request from justbur/autoload-keymap

Correct prefix keys after use-package-autoload-keymap
GitHub-reference: https://github.com/jwiegley/use-package/issues/686

Merge pull request from jwiegley/ensure-system-package-filepath

allow :ensure-system-package to check the presence of files at path
GitHub-reference: https://github.com/jwiegley/use-package/issues/703

allow :ensure-system-package to check the presence of files at path

closes https://github.com/jwiegley/use-package/issues/660

Merge pull request from killdash9/patch-1

Place :chords at beginning of use-package-keywords
GitHub-reference: https://github.com/jwiegley/use-package/issues/697

Place :chords at beginning of use-package-keywords

When it is at the end, the keys don't get bound until after the package has been loaded, which is bad.  Placing it at the beginning allows the key bindings to be mapped to auto-loaded functions before the package is loaded, so that a key chord press triggers the package load.

Merge pull request from killdash9/patch-1

New style of auto-deferral for chords
GitHub-reference: https://github.com/jwiegley/use-package/issues/658

Merge branch 'master' into patch-1

Merge pull request from jabranham/enable-lexical-binding

Enable lexical binding
GitHub-reference: https://github.com/jwiegley/use-package/issues/657

Fix use-package-normalize-function

Fix use-package-normalize-function tests

Enable lexical binding

This supersedes https://github.com/jwiegley/use-package/issues/617 and closes https://github.com/jwiegley/use-package/issues/648

Merge pull request from taingra/master

Added an Introduction taken from the README
GitHub-reference: https://github.com/jwiegley/use-package/issues/692

Update use-package.texi

Added an Introduction taken from the README

Copyright-paperwork-exempt: yes

Correct prefix keys after use-package-autoload-keymap

By adding events of the form (cons t event) to unread-command-events, Emacs
correctly updates this-command-keys for the subsequent use of the prefix.

Before this change, packages like my which-key were not getting the correct
prefix after use-package-autoload-keymap loaded the relevant package.

See https://github.com/justbur/emacs-which-key/issues/192

Merge pull request from akhramov/fix/ensure-system-package-cleanup

ensure-system-package cleanup
GitHub-reference: https://github.com/jwiegley/use-package/issues/683

Ensure system package cleanup

The function introduced in https://github.com/jwiegley/use-package/issues/673 wasn't declared at compile time, and
it made byte compiler unhappy. Moreover, it was forgotten to remove
redundant compile time variables. Thanks @tarsius for pointing that
out.

This change
* Removes redundant variable declarations
* Adds `system-packages-get-command` function declaration.

Copyright-paperwork-exempt: yes

fix gethash default value for use-package-statistics-time

float-time expect list like (HIGH LOW USEC PSEC)
> HIGH has the most significant bits of the seconds, while LOW has the
> least significant 16 bits.  USEC and PSEC are the microsecond and
> picosecond counts.
by `current-time` in editfns.c

Merge pull request from andschwa/remap-command

Document that remapping commands is supported with bind-key
GitHub-reference: https://github.com/jwiegley/use-package/issues/674

Document that remapping commands is supported with bind-key

Copyright-paperwork-exempt: yes

Merge pull request from akhramov/fix/ensure-system-package-noconfirm

[Fix https://github.com/jwiegley/use-package/issues/661] ensure-system-package: honor system-packages customizations
GitHub-reference: https://github.com/jwiegley/use-package/issues/673

[] ensure-system-package: honor system-packages customizations

ensure-system-package doesn't honor system-packages
customizations (https://github.com/jwiegley/use-package/issues/661), because system-packages didn't provide an API
to retrieve shell command to be executed.

This change makes use of the new system-packages'
`system-package-get-command` function and therefore fixes the issue.
GitHub-reference: fix https://github.com/jwiegley/use-package/issues/661
Copyright-paperwork-exempt: yes

Update use-package-chords.el

Update use-package-chords.el

new style of auto-deferral for chords

Merge pull request from waymondo/master

:ensure-system-package - allow cdr of cons to be a package name symbol
GitHub-reference: https://github.com/jwiegley/use-package/issues/654

:ensure-system-package allow cdr of cons to be a package name symbol

closes https://github.com/jwiegley/use-package/issues/652

Merge pull request from valignatev/master

Encourage installation via https instead of http
GitHub-reference: https://github.com/jwiegley/use-package/issues/651

Encourage installation via https instead of http

Merge pull request from DamienCassou/fix-report-again

Fix report again after revert
GitHub-reference: https://github.com/jwiegley/use-package/issues/647

Fix compile-time warnings due to the statistics-reporting code

The code worked because the file is using dynamic binding.

Add missing require

This is used for `hash-table-keys`.

Fix https://github.com/jwiegley/use-package/issues/644.

Merge pull request from jwiegley/revert-645-fix-report

Revert "Fix report"
GitHub-reference: https://github.com/jwiegley/use-package/issues/646

Revert "Fix report"

Merge pull request from DamienCassou/fix-report

Fix report
GitHub-reference: https://github.com/jwiegley/use-package/issues/645

Fix compile-time warnings due to the statistics-reporting code

The code worked because the file is using dynamic binding.

Add missing require

This is used for `hash-table-keys`.

Fix https://github.com/jwiegley/use-package/issues/644.

Merge pull request from DamienCassou/tabulated-list

Use a tabulated-list to display package configuration statistics
GitHub-reference: https://github.com/jwiegley/use-package/issues/642

Use a tabulated-list to display package configuration statistics

Fix https://github.com/jwiegley/use-package/issues/641

Merge pull request from matthewbauer/patch-1

Support ":package" in use-package
GitHub-reference: https://github.com/jwiegley/use-package/issues/633

Support ":package" in use-package

bind-key supports the keyword ":package" but use-package does not know that. Adding this should be helpful. In the future, maybe we could automatically fill in with the use-package package, but that could be a breaking change.

Merge pull request from justbur/normalize-fix

Fix usage of plist argument in use-package-normalize-plist
GitHub-reference: https://github.com/jwiegley/use-package/issues/625

Fix usage of plist argument in use-package-normalize-plist

Previously the argument was never used.

Merge pull request from justbur/ignore-keywords

Add use-package-ignore-unknown-keywords option
GitHub-reference: https://github.com/jwiegley/use-package/issues/624

Add use-package-ignore-unknown-keywords option

This option allows use-package to skip over keywords it doesn't recognize.

Revert "Merge pull request from jabranham/lexical-bindings"

This reverts commit d21787f1d64a740c0e00899835d9200a0e4690df, reversing
changes made to fd8a3510fd1a555b925f57b2870917e3c4ea0206.
GitHub-reference: https://github.com/jwiegley/use-package/issues/617

Revert "Move variable bindings to the bottom of each file"

This reverts commit c29193bf0724633adf7183dad2d0b6faf7d029ab.

Move variable bindings to the bottom of each file