Re: emacs-29 acd462b0306: ; Improve the use-package manual

[Stefan Kangas]

John Yates <john@yates-sheets.org> writes:

> I have employed a use-package since my most recent emacs
> bankruptcy five or so years back.  Early on I struggled
> to come up with an appropriate ordering of keywords.
> Clearly many are purely declarative.  But some result
> in declarations and/or executable code.
>
> Hence this use-package comment in my .init file:
>
> ;; Order insensitive metadata (neither introduces nor references any
> symbols, nor executes any code):
[...]
> ;; Order sensitive (may introduce, reference or modify symbols, and/or
> may execute code):

What do you mean by "ordering of keywords"?  AFAIU, keywords are
processed in the order they appear in `use-package-keywords'.

I'm not sure why `use-package-keywords' is a defcustom though.  It
should only ever be changed by people implementing new keywords, and not
by users, IIUC.