51d3b1b424
This is first of three big naming convention updates that have been a
long time coming. With 2.1 on the horizon, all the breaking updates will
batched together in preparation for the long haul.
In this commit, we do away with the asterix to communicate that a
function is an advice function, and we replace it with the '-a' suffix.
e.g.
doom*shut-up -> doom-shut-up-a
doom*recenter -> doom-recenter-a
+evil*static-reindent -> +evil--static-reindent-a
The rationale behind this change is:
1. Elisp's own formatting/indenting tools would occasionally struggle
with | and * (particularly pp and cl-prettyprint). They have no
problem with / and :, fortunately.
2. External syntax highlighters (like pygmentize, discord markdown or
github markdown) struggle with it, sometimes refusing to highlight
code beyond these symbols.
3. * and | are less expressive than - and -- in communicating the
intended visibility, versatility and stability of a function.
4. It complicated the regexps we must use to search for them.
5. They were arbitrary and over-complicated to begin with, decided
on haphazardly way back when Doom was simply "my private config".
Anyhow, like how predicate functions have the -p suffix, we'll adopt the
-a suffix for advice functions, -h for hook functions and -fn for
variable functions.
Other noteable changes:
- Replaces advice-{add,remove}! macro with new def-advice!
macro. The old pair weren't as useful. The new def-advice! saves on a
lot of space.
- Removed "stage" assertions to make sure you were using the right
macros in the right place. Turned out to not be necessary, we'll
employ better checks later.
|
||
|---|---|---|
| .. | ||
| autoload.el | ||
| config.el | ||
| doctor.el | ||
| packages.el | ||
| README.org | ||
lang/rust
Description
Add support to Rust language and cargo commands inside emacs.
- Code completion (
racer) - Syntax checking (
flycheck) - Snippets
Module Flags
+lspto add support Language server protocol.
Plugins
Hacks
{A list of internal modifications to included packages}
Prerequisites
To get started with Rust, you can either use rustup and install rust with:
curl https://sh.rustup.rs -sSf | sh
Package manager is not recommended to install Nightly version of Rust what is
required for racer from version 2.1 (more info in Troubleshooting)
Some commands require additional crates to be installed to work, e.g. cargo
add.
rustup component add rustfmt
rustup component add cargo-check
rustup component add cargo-editFeatures
This module also supports LSP, it requires installation of Rust Language Server
RLS. To enable this you need to enable lsp in :tools section in init.el file.
Keybindings
| Binding | Description |
|---|---|
<localleader> b a |
cargo add |
<localleader> b b |
cargo build |
<localleader> b B |
cargo bench |
<localleader> b c |
cargo check |
<localleader> b C |
cargo clippy |
<localleader> b d |
cargo doc |
<localleader> b r |
cargo run |
<localleader> b s |
cargo search |
<localleader> b u |
cargo update |
<localleader> t a |
cargo test |
<localleader> t f |
run tests in current file |
<localleader> t t |
run current test |
TODO Configuration
How to configure this module, including common problems and how to address them.
Troubleshooting
Racer installation problems
Racer need now (From 2.1 version) nightly version of Rust
If you installed trough rustup
rustup toolchain add nightly
cargo +nightly install racer