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

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

[Arash Esbati]

Hi all,

use-package.texi contains this example[1]:

  @lisp
  @group
  ;; Completely hide visual-line-mode and change auto-fill-mode to " AF".
  (use-package emacs
    :delight
    (auto-fill-function " AF")
    (visual-line-mode))
  @end group
  @end lisp

The usage of (use-package emacs ...) isn't described anywhere in the
file, though.  There was a discussion about it here[2], but I think it
should be documented in the manual somehow.  I'm not familiar enough
with use-package to make a suggestion, sorry.

Best, Arash

Footnotes:
[1]  https://git.savannah.gnu.org/cgit/emacs.git/tree/doc/misc/use-package.texi#n1539

[2]  https://www.reddit.com/r/emacs/comments/mk9ehd/curious_whats_the_use_of_usepackage_emacs/

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

[Eli Zaretskii]

> From: Arash Esbati <arash@gnu.org>
> Date: Wed, 04 Oct 2023 23:29:26 +0200
> 
> Hi all,
> 
> use-package.texi contains this example[1]:
> 
>   @lisp
>   @group
>   ;; Completely hide visual-line-mode and change auto-fill-mode to " AF".
>   (use-package emacs
>     :delight
>     (auto-fill-function " AF")
>     (visual-line-mode))
>   @end group
>   @end lisp
> 
> The usage of (use-package emacs ...) isn't described anywhere in the
> file, though.  There was a discussion about it here[2], but I think it
> should be documented in the manual somehow.  I'm not familiar enough
> with use-package to make a suggestion, sorry.
> 
> Best, Arash
> 
> Footnotes:
> [1]  https://git.savannah.gnu.org/cgit/emacs.git/tree/doc/misc/use-package.texi#n1539
> 
> [2]  https://www.reddit.com/r/emacs/comments/mk9ehd/curious_whats_the_use_of_usepackage_emacs/

Adding John, in case he has any thoughts about this.

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

[John Wiegley]

>>>>> 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.

-- 
John Wiegley                  GPG fingerprint = 4710 CF98 AF9B 327B B80F
http://newartisans.com                          60E1 46C4 BD1A 7AC1 4BA2

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

[Arash Esbati]

John Wiegley <johnw@gnu.org> writes:

> 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 for your response.  I wonder which use-package keywords don't
make sense in that form?  The way I see it things like :defer, :init et
al. are useless since we're talking about Emacs with all preloaded
libraries, right?

Best, Arash