feat: disable JIT native compilation by default

Newcomers may find background JIT compilation confusing as it causes
unpredictable sluggishness. Disable it by default and add comments
guiding users on how to re-enable it for extra performance.

Update README to reflect the new behavior.
This commit is contained in:
Rahul Martim Juliato
2026-02-15 17:19:17 -03:00
parent ae874711be
commit b99a679a76
2 changed files with 21 additions and 7 deletions

View File

@@ -137,12 +137,12 @@ configuration.
grammars and download some fonts. This configuration uses **Nerd Fonts** by
default, so installing them now is highly recommended for the best experience.
**VERY IMPORTANT**: On first launch, Emacs will also **native compile some
external packages**, which may take a little time. Additionally, the first time
you perform certain actions, like opening the tree explorer, Emacs may compile
related components in the background. This is completely normal and only
happens once per feature. You might notice a brief moment of sluggish
performance during this initial compilation.
**VERY IMPORTANT**: On first launch, Emacs will **byte-compile** some external
packages, which may take a little time. This is completely normal and only
happens once. Subsequent launches will be fast. Note that JIT native compilation
is disabled by default in this config to avoid confusing background compilation.
If you want extra performance, see the comments around `native-comp-jit-compilation`
in `init.el` on how to enable it.
3. **Set terminal mode by default**: