fbdde6b5f4
BREAKING CHANGE: Moves ws-butler, dtrt-indent, and whitespace defaults out of Doom's core and into a new module. ws-butler is gated behind +trim and dtrt-indent behind +guess. Users who depend on/like these packages will need to enable the new module and their respective flags (which is the default going forward). This change is motivated by an ongoing effort to slim down Doom's core (by (re)moving non-essentials from it). This also addresses an issue where dtrt-indent would vastly increase load times for some major-modes (e.g. elixir-mode & elm-mode, see #7537) by restricting it to non-project files and non-read-only buffers AND excludign those two major modes from indent guessing. Fix: #8516 Fix: #7537
:tools editorconfig
Description unfold
This module adds EditorConfig support to Emacs, allowing users to dictate code
style on a per-project basis with .editorconfig files (formal specification),
with or without the native editorconfig binary.
Maintainers
Module flags
This module has no flags.
Packages
Hacks
- Special integration for
ws-butler: this module will use doom-package:ws-butler to enforcetrim_trailing_whitespace.
TODO Changelog
This module does not have a changelog yet.
Installation
Enable this module in your doom! block.
This module has one optional dependency: the native editorconfig binary.
Without it, a built-in elisp implementation will be used, which is claimed to be
faster and more secure.
If you choose to install the binary, many implementations are available, usually through your OS package manager (if not built from source yourself).
Usage
A .editorconfig file in your project (usually in the root directory of the
project) is needed to configure code style for files in the same directory or
below. Documentation on editorconfig's properties can be found here.
TODO Configuration
This module's configuration documentation is incomplete. Complete it?
Adding support for more major modes
Out the box, the editorconfig plugin supports many Emacs major modes, but it's
possible you'll find one it doesn't support. Adding support is easy so long as
you know that mode's indentation variables. For example, coffee-mode has a
coffee-tab-width variable that controls indentation width in CoffeeScript
files. Editorconfig already supports this language, but let's pretend it
doesn't:
The editorconfig-indentation-alist variable contains a list of major modes and
their indentation variables. To add coffee-mode to it:
;; in $DOOMDIR/config.el
(after! editorconfig
(add-to-list 'editorconfig-indentation-alist '(coffee-mode coffee-tab-width)))
But what if you don't know the correct indentation variable(s). Use SPC h v (C-h
v for non-evil users) to peruse all the available variables in your current
session of Emacs. Look for variables that have the words indent, offset or
tab-width in them. They will be prefixed with the plugin they belong to (e.g.
rustic-indent-offset).
Troubleshooting
There are no known problems with this module. Report one?
Frequently asked questions
This module has no FAQs yet. Ask one?
TODO Appendix
This module has no appendix yet. Write one?