Files
doomemacs/modules/tools/editorconfig
Jeetaditya Chatterjee 2fa0dca041 doc/adding editorconfig and hl-column-fill documentation (#3815)
* doc/adding editor config and hl-column-fill docs

* Adding inaugural versons to the modules

* Making the requested edits

* adding in some more spaces

* redoing the review

* ui/fill-column: correct & expand readme

Co-authored-by: Henrik Lissner <henrik@lissner.net>
2021-03-05 22:35:06 -05:00
..
2019-04-24 18:16:04 -04:00
2021-02-25 13:59:43 -05:00

tools/editorconfig

Description

Add EditorConfig integration for Doom

EditorConfig helps maintain consistent coding styles for multiple developers working on the same project across various editors and IDEs. The EditorConfig project consists of a file format for defining coding styles and a collection of text editor plugins that enable editors to read the file format and adhere to defined styles. EditorConfig files are easily readable and they work nicely with version control systems.

This module…

  • Adds support for editorconfig properties through the plugin
  • Provides a rudimentary back-end for editorconfig parsing

Maintainers

This module has no dedicated maintainers

Module Flags

This module provides no flags.

Prerequisites

The editorconfig binary is an optional requirement of this module. the elisp only implementation may be sufficient, but has fewer features and is slower in most cases. You may get an advantage by installing one of the many EditorConfig core implementations either from your package manager or from source

Features

You will need to write an .editorconfig file in your project (this is usually in the root of your project) you can find out about all the properties here

Configuration

Adding Major Modes

If you don't know the indentation variable(s), use SPC h v to search for variables that have indent, offset or tab-width in their name. Likely prefixed with the plugin they belong to. e.g. rustic-indent-offset).

(after! editorconfig
  ;; This entry already exists in `editorconfig-indentation-alist'; it is being used
  ;; as an example.
  (add-to-list 'editorconfig-indentation-alist '(c-mode c-basic-offset))
  (add-to-list 'editorconfig-indentation-alist '(coffee-mode coffee-tab-width)))

If you do not know the indentation variable/variables, (in the major mode in question use SPC h v to look for any variable that has indent, offset or tab-width in its name.)

TODO Troubleshooting