You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+44-22Lines changed: 44 additions & 22 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -128,47 +128,64 @@ The [super-save](https://github.com/bbatsov/super-save) package also used to be
128
128
129
129
## Upgrading to Prelude 2.0
130
130
131
-
Prelude 2.0 is a major release that modernizes the entire distribution around Emacs 29+ features. Here's what you need to know:
131
+
Prelude 2.0 is a major release that modernizes the entire
132
+
distribution around Emacs 29+ features. Here's what you need to know:
132
133
133
134
### Emacs 29.1 is now required
134
135
135
-
Prelude no longer supports Emacs 28 or older. If you haven't upgraded yet, now's the time. Emacs 29 brings built-in tree-sitter, Eglot (LSP client), `use-package`, and many other improvements that Prelude 2.0 takes full advantage of.
136
+
Prelude no longer supports Emacs 28 or older. If you haven't
137
+
upgraded yet, now's the time. Emacs 29 brings built-in tree-sitter,
138
+
Eglot (LSP client), `use-package`, and many other improvements that
139
+
Prelude 2.0 takes full advantage of.
136
140
137
141
### Tree-sitter support
138
142
139
-
For built-in modes that ship both classic and tree-sitter variants (e.g., `python-mode` / `python-ts-mode`), Prelude automatically selects the tree-sitter version when a grammar is available and falls back to the classic mode when it isn't. Some modules use tree-sitter modes unconditionally (e.g., `prelude-ocaml` uses `neocaml` which is tree-sitter-only), though such modes typically auto-install their grammars.
143
+
For built-in modes that ship both classic and tree-sitter variants
selects the tree-sitter version when a grammar is available and falls
146
+
back to the classic mode when it isn't. Some modules use tree-sitter
147
+
modes unconditionally (e.g., `prelude-ocaml` uses `neocaml` which is
148
+
tree-sitter-only), though such modes typically auto-install their
149
+
grammars.
140
150
141
-
To install tree-sitter grammars, use `M-x treesit-install-language-grammar`. See the [Emacs manual](https://www.gnu.org/software/emacs/manual/html_node/emacs/Language-Grammar.html) for details.
Prelude 2.0 adds LSP support to most language modules using Eglot (built-in since Emacs 29) as the default client. If you were previously using `prelude-lsp` with lsp-mode, note that:
159
+
Prelude 2.0 adds LSP support to most language modules using Eglot
160
+
(built-in since Emacs 29) as the default client. If you were
161
+
previously using `prelude-lsp` with lsp-mode, note that:
146
162
147
163
- The module has been renamed to `prelude-lsp-mode`.
148
-
- Set `(setq prelude-lsp-client 'lsp-mode)` in your personal config to keep using lsp-mode.
164
+
- Set `(setq prelude-lsp-client 'lsp-mode)` in your personal
165
+
config to keep using lsp-mode.
149
166
- The default is now Eglot -- no extra packages needed.
150
167
- Eglot keybindings live under `C-c C-l` (rename, code actions, format, etc.).
151
168
152
169
### Removed packages and modules
153
170
154
171
Several outdated packages have been replaced by built-in alternatives:
|`prelude-selectrum`| Use `prelude-vertico` instead |
168
185
169
186
### Keybinding changes
170
187
171
-
-`C-x p` no longer opens `proced` (this prefix is now reserved for `project.el`).
188
+
-`C-x p` no longer opens `proced` (reserved for `project.el`).
172
189
-`C-x C-m` runs `execute-extended-command` instead of `smex`.
173
190
-`C-c c` is bound to `org-capture`.
174
191
-`C-c C-l` prefix is used for Eglot commands in programming modes.
@@ -177,9 +194,14 @@ Several outdated packages have been replaced by built-in alternatives:
177
194
178
195
1.**Update Emacs** to 29.1 or newer.
179
196
2.**Pull the latest Prelude** and restart Emacs. Packages will be updated automatically.
180
-
3.**Review your `prelude-modules.el`** -- if you had `prelude-lsp` enabled, rename it to `prelude-lsp-mode`. If you want Eglot (recommended), you don't need any LSP module enabled.
181
-
4.**Install tree-sitter grammars** for your languages of choice (optional but recommended).
182
-
5.**Check your personal config** for references to removed packages (`nlinum`, `anzu`, `epl`, `anaconda-mode`, `js2-mode`, `tide`, `alchemist`).
197
+
3.**Review your `prelude-modules.el`** -- if you had `prelude-lsp`
198
+
enabled, rename it to `prelude-lsp-mode`. If you want Eglot
199
+
(recommended), you don't need any LSP module enabled.
200
+
4.**Install tree-sitter grammars** for your languages of choice
201
+
(optional but recommended).
202
+
5.**Check your personal config** for references to removed packages
0 commit comments