Document (use-package 'emacs) declarations
* doc/misc/use-package.texi (The @code{emacs} package): New node. (Bug#66350)
This commit is contained in:
parent
de9f9add13
commit
c7609464f7
1 changed files with 29 additions and 0 deletions
|
@ -252,6 +252,7 @@ on Emacs start. @xref{Installing packages}, for details.
|
||||||
* Forcing loading:: Loading packages immediately.
|
* Forcing loading:: Loading packages immediately.
|
||||||
* Conditional loading:: Loading packages conditionally.
|
* Conditional loading:: Loading packages conditionally.
|
||||||
* Loading sequentially:: Loading packages in sequence.
|
* Loading sequentially:: Loading packages in sequence.
|
||||||
|
* The @code{emacs} package:: Customizing built-in variables.
|
||||||
* Load dependencies:: Don't load without dependencies.
|
* Load dependencies:: Don't load without dependencies.
|
||||||
* Manual installation:: Loading manually installed packages.
|
* Manual installation:: Loading manually installed packages.
|
||||||
@end menu
|
@end menu
|
||||||
|
@ -567,6 +568,34 @@ registers autoloads, such as @code{:bind} or @code{:hook}
|
||||||
it is possible that your package will never be loaded if you do not
|
it is possible that your package will never be loaded if you do not
|
||||||
add @code{:demand t} to those declarations.
|
add @code{:demand t} to those declarations.
|
||||||
|
|
||||||
|
@node The @code{emacs} package
|
||||||
|
@section Customizing built-in variables
|
||||||
|
@cindex customizing built-in variables
|
||||||
|
|
||||||
|
Some users want to put all their customizations in use-package
|
||||||
|
declarations, even for variables, hooks, and options that are always
|
||||||
|
available, without loading any package.@footnote{In other words, they
|
||||||
|
are either preloaded in Emacs or defined in Emacs' C sources.}
|
||||||
|
|
||||||
|
For that purpose, you can use the no-op @samp{emacs} package:
|
||||||
|
|
||||||
|
@lisp
|
||||||
|
@group
|
||||||
|
(use-package emacs
|
||||||
|
:init
|
||||||
|
(setq custom-file "~/.emacs.d/emacs-custom.el")
|
||||||
|
(load custom-file)
|
||||||
|
(setq frame-title-format "%b")
|
||||||
|
:custom
|
||||||
|
(use-short-answers t))
|
||||||
|
@end group
|
||||||
|
@end lisp
|
||||||
|
|
||||||
|
This declaration takes advantage of the fact that @w{@code{(featurep
|
||||||
|
'emacs)}} always returns true, and has no special meaning beyond that.
|
||||||
|
It simply provides a way to organize your customizations, without
|
||||||
|
loading anything.
|
||||||
|
|
||||||
@node Load dependencies
|
@node Load dependencies
|
||||||
@section Prevent loading if dependencies are missing
|
@section Prevent loading if dependencies are missing
|
||||||
@cindex prevent loading package if dependencies are missing
|
@cindex prevent loading package if dependencies are missing
|
||||||
|
|
Loading…
Add table
Reference in a new issue