spacemacs/layers/+checkers/syntax-checking
Benjamin Reynolds b6474ff590 Fix various documentation errors and inconsistencies
Fixes documentation errors from issue #9476 in the following layers...

* syntax-checking
* games
* xkcd
* keyboard-layout
* racket
* osx
2017-10-05 11:15:21 +03:00
..
img layers directory: create new categories 2016-03-23 21:39:43 -04:00
config.el Bump year in copyright headers 2017-01-05 23:08:17 -05:00
funcs.el syntax-checking: SPC e e trigger a check SPC e x to explain error 2017-03-19 12:40:36 -04:00
packages.el Use a more consistent keybinding for flycheck-buffer 2017-06-08 09:23:23 +02:00
README.org Fix various documentation errors and inconsistencies 2017-10-05 11:15:21 +03:00

Syntax Checking layer

/TakeV/spacemacs/media/commit/2cb3bd6e747179e19d1e395d2bbe842641432061/layers/+checkers/syntax-checking/img/flycheck.png

Description

This layer provides on the fly syntax checking using Flycheck.

Features:

  • Automatic syntax checking with Flycheck
  • Tooltip syntax errors with popwin

Install

Layer

To use this configuration layer, add it to your ~/.spacemacs. You will need to add syntax-checking to the existing dotspacemacs-configuration-layers list in this file.

Enabling/Disabling tooltips

By default tooltips are enabled and used whenever it is possible. You can disable them by setting the variable syntax-checking-enable-tooltips to nil:

(setq-default dotspacemacs-configuration-layers
  '((syntax-checking :variables syntax-checking-enable-tooltips nil)))

Disabling by default

By default, syntax-checking is enabled in all available major modes (except for emacs-lisp-mode) and may be toggled off with SPC t s. You can default this to off by setting the variable syntax-checking-enable-by-default to nil:

(setq-default dotspacemacs-configuration-layers
  '((syntax-checking :variables syntax-checking-enable-by-default nil)))

If you want more fine-grained control, you can configure the variable flycheck-global-modes instead. Note that this variable should be manipulated in dotspacemacs/user-config.

Bitmaps

If the original flycheck fringe bitmaps are more to your liking, you can set the variable syntax-checking-use-original-bitmaps to t:

(setq-default dotspacemacs-configuration-layers
  '((syntax-checking :variables syntax-checking-use-original-bitmaps t)))

Key Bindings

Key Binding Description
SPC e b check for errors now
SPC e c clear errors
SPC e h describe flycheck checker
SPC e l display a list of all the errors
SPC e L display a list of all the errors and focus the errors buffer
SPC e s set flycheck checker
SPC e S set flycheck checker executable
SPC e v verify flycheck setup
SPC t s toggle flycheck
SPC e x explain the error at point