1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
|
.. _flycheck-installation:
==============
Installation
==============
This document gives you detailed instructions and information about installing
Flycheck.
Prerequisites
=============
Flycheck needs GNU Emacs |min-emacs| and works best on Unix-like systems like
Linux or macOS. It does not support older releases of GNU Emacs or other
flavours of Emacs (e.g. XEmacs, Aquamacs, etc.).
.. _flycheck-windows-support:
Windows support
---------------
**Flycheck does not explicitly support Windows**, but tries to maintain Windows
compatibility and should generally work fine on Windows, too. However, we can
neither answer questions about Windows nor fix bugs that only occur on Windows
without the help of active Windows users. Please watch out for `known Windows
issues`_.
.. _known Windows issues: https://github.com/flycheck/flycheck/labels/B-Windows%20only
Syntax checking tools
---------------------
Flycheck does not check buffers itself but relies on *external* programs to
check buffers. These programs must be installed separately. Please take a look
at the :ref:`list of supported languages <flycheck-languages>` to find out what
tools are required for a particular language.
Many of these programs are available in the package repositories of Linux
distributions or in Homebrew_ for macOS. Others can be installed with standard
package managers such as Rubygems, NPM, Cabal, etc.
.. important::
For a GUI Emacs on MacOS we recommend to install and configure
exec-path-from-shell_ to make Emacs use the proper ``$PATH`` and avoid a
:ref:`common setup issue on MacOS <flycheck-macos-exec-path-from-shell>`.
.. _Homebrew: http://brew.sh
.. _exec-path-from-shell: https://github.com/purcell/exec-path-from-shell
.. _flycheck-package-installation:
Package installation
====================
We recommend to install Flycheck with Emacs' built-in package manager. Flycheck
is available in the popular `MELPA Stable`_ archive which provides packages for
Flycheck releases. We recommend to read through the :doc:`changelog </changes>`
before every upgrade to check for any breaking changes that might affect you.
.. note::
The sibling repository `MELPA Stable`_ serves up to date snapshots of
Flycheck's development state. If you prefer to follow the most recent
changes use MELPA instead, but be aware that we make breaking changes anytime
without prior announcement.
Unfortunately the MELPA repositories are not available in Emacs by default. You
must explicitly add them to `package-archives` with the following code in your
:term:`init file`:
.. code-block:: elisp
(require 'package)
(add-to-list 'package-archives
'("MELPA Stable" . "https://stable.melpa.org/packages/") t)
(package-initialize)
This adds MELPA Stable; for MELPA replace ``https://stable.melpa.org`` with
``https://melpa.org`` and change the name accordingly. If you do not know where
your init file is inspect the value of `user-init-file` with :kbd:`C-h v
user-init-file`.
Once the repository is set up you can install Flycheck from Emacs' package menu
at :kbd:`M-x list-packages`, or directly with :kbd:`M-x package-install RET
flycheck`.
use-package
-----------
You may want to take a look at `use-package`_ which provides simple syntax to
declare and configure packages in your init file. In addition to the Github
README the article `My Emacs configuration with use-package`_ has more
information about use-package. Specifically it allows to automatically install
missing packages from package archive when Emacs starts.
Add the following form to your init file to setup Flycheck with `use-package`_:
.. code-block:: elisp
(use-package flycheck
:ensure t
:init (global-flycheck-mode))
Then press :kbd:`C-M-x` with point somewhere in this form to install and enable
Flycheck for the current Emacs session.
.. _flycheck-distribution-packages:
Distribution packages
---------------------
Alternatively some distributions provide binary packages of Flycheck. We
officially support the following distributions:
* Debian 9 and newer: ``apt-get install elpa-flycheck flycheck-doc`` (the latter
for our manual). The `Debian Emacs addon team`_ provides these packages.
.. _Debian Emacs addon team: https://pkg-emacsen.alioth.debian.org/
.. _flycheck-legacy-installation-methods:
Legacy installation methods
===========================
Some users prefer to install Flycheck with legacy methods such as el-get, Git
submodules, etc that were common before Emacs included a package manager. There
are also many 3rd party packages provided by various package managers. We do
neither support nor endorse any of these:
.. warning::
If you install Flycheck in any way other than :ref:`our official packages
<flycheck-package-installation>` you do so **at your own risk**.
Please beware of breakage, and understand that while we do not actively work
against alternative installation methods we will not make compromises to support
alternative installation methods. We will close issues reported for alternative
installation if we fail to reproduce them with a proper installation of
Flycheck.
.. _MELPA: https://melpa.org
.. _MELPA Stable: https://stable.melpa.org
.. _Getting Started: https://melpa.org/#/getting-started
.. _use-package: https://github.com/jwiegley/use-package
.. _My Emacs configuration with use-package: http://www.lunaryorn.com/posts/my-emacs-configuration-with-use-package.html
|
