bug#66350: 30.0.50; Description for (use-package emacs ...)

[Arash Esbati]

John Wiegley <johnw@gnu.org> writes:

>>>>>> Eli Zaretskii <eliz@gnu.org> writes:
>
>>> (use-package emacs
>
>> Adding John, in case he has any thoughts about this.
>
> The ‘(use-package emacs …)‘ declaration has no special meaning. It just takes
> advantage of the fact that ‘(featurep 'emacs)‘ is always true, so in a way
> it’s just for consistency’s sake, and doesn’t actually do anything special.

Thanks.  In order to close this report, I suggest to add the following
to the manual:

--8<---------------cut here---------------start------------->8---
diff --git a/doc/misc/use-package.texi b/doc/misc/use-package.texi
index c2b6404b68b..e0a156eb373 100644
--- a/doc/misc/use-package.texi
+++ b/doc/misc/use-package.texi
@@ -181,7 +181,7 @@ Getting Started
 immediately.  In most cases, this is not necessary or desirable, as
 that will slow down Emacs startup.  Instead, you should try to set
 things up so that packages are only loaded when they are actually
-needed (a.k.a. ``autoloading'').  If you have installed a package from
+needed (a.k.a.@: ``autoloading'').  If you have installed a package from
 @acronym{GNU} @acronym{ELPA} that provides it's own autoloads, it is often
 enough to say:

@@ -225,6 +225,21 @@ Getting Started
 that you can use.  Where possible, it is a good idea to copy them, and
 use that as a starting point.

+You can also configure variables defined in Emacs C sources or preloaded
+with Emacs with 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
+
 That should be enough to get you started!

 @c ----------------------------------------------------------------------------
--8<---------------cut here---------------end--------------->8---

If the question is too trivial, we can close it as wontfix.

Best, Arash