1
0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2024-11-21 06:55:39 +00:00

Document issues with 'use-package's ':custom' and byte compilation

* doc/misc/use-package.texi (User options): Warn against
byte-compiling init files that use ':custom'.  (Bug#73609)
This commit is contained in:
Eli Zaretskii 2024-11-09 11:55:49 +02:00
parent 775970a783
commit b1be0f2ba6

View File

@ -1416,6 +1416,13 @@ for the same variable, as this risks having conflicting values in your
use-package declaration and your @code{custom-file}, which can lead to
problems that are both tricky and tedious to debug.
Also note that if you use @code{:custom} in a file that you
byte-compile, you could have some unexpected results if you later load
or @code{require} @file{use-package} (e.g., due to lazy loading): the
value of the corresponding user options could be reset back to their
initial values. We therefore recommend against byte-compiling files
that use @file{use-package} with @code{:custom} settings.
@node Faces
@section Faces
@cindex faces, setting