2011-12-27 14:04:35 -05:00
|
|
|
,
|
|
|
|
/ \,,_ .'|
|
2011-12-27 14:10:00 -05:00
|
|
|
,{{| /}}}}/_.' _____________________________________________
|
2011-12-27 14:04:35 -05:00
|
|
|
}}}}` '{{' '. / \
|
2012-11-14 14:36:24 -05:00
|
|
|
{{{{{ _ ;, \ / Ladies and Gentlemen, \
|
2011-12-27 14:04:35 -05:00
|
|
|
,}}}}}} /o`\ ` ;) | |
|
|
|
|
{{{{{{ / ( | this is ... |
|
|
|
|
}}}}}} | \ | |
|
|
|
|
{{{{{{{{ \ \ | |
|
|
|
|
}}}}}}}}} '.__ _ | | _____ __ __ _ |
|
|
|
|
{{{{{{{{ /`._ (_\ / | / ___/__ ______ / /_____ ______/ /_(_)____ |
|
|
|
|
}}}}}}' | //___/ --=: \__ \/ / / / __ \/ __/ __ `/ ___/ __/ / ___/ |
|
|
|
|
jgs `{{{{` | '--' | ___/ / /_/ / / / / /_/ /_/ (__ ) /_/ / /__ |
|
|
|
|
}}}` | /____/\__, /_/ /_/\__/\__,_/____/\__/_/\___/ |
|
|
|
|
| /____/ |
|
2011-12-27 14:10:00 -05:00
|
|
|
| /
|
|
|
|
\_____________________________________________/
|
2011-12-27 14:04:35 -05:00
|
|
|
|
|
|
|
|
2014-02-03 01:23:00 -05:00
|
|
|
- - -
|
2014-12-04 03:58:47 -05:00
|
|
|
1. [Introduction](#introduction)
|
|
|
|
2. [Installation](#installation)
|
|
|
|
2.1. [Requirements](#requirements)
|
|
|
|
2.2. [Installing syntastic with Pathogen](#installpathogen)
|
2015-01-06 01:20:50 -05:00
|
|
|
3. [Recommended settings](#settings)
|
|
|
|
4. [FAQ](#faq)
|
|
|
|
4.1. [I installed syntastic but it isn't reporting any errors...](#faqinfo)
|
2016-08-31 03:14:03 -04:00
|
|
|
4.2. [Syntastic supports several checkers for my filetype, how do I tell it which one(s) to use?](#faqcheckers)
|
2016-10-10 15:57:17 -04:00
|
|
|
4.3. [How can I run checkers for "foreign" filetypes against the current file?](#faqforeign)
|
2016-10-09 04:08:06 -04:00
|
|
|
4.4. [I have enabled multiple checkers for the current filetype. How can I display all errors from all checkers together?](#faqaggregate)
|
|
|
|
4.5. [How can I pass additional arguments to a checker?](#faqargs)
|
|
|
|
4.6. [I run a checker and the location list is not updated...](#faqloclist)
|
|
|
|
4.6. [I run`:lopen` or `:lwindow` and the error window is empty...](#faqloclist)
|
|
|
|
4.7. [How can I jump between the different errors without using the location list at the bottom of the window?](#faqlnext)
|
|
|
|
4.8. [The error window is closed automatically when I `:quit` the current buffer but not when I `:bdelete` it?](#faqbdelete)
|
|
|
|
4.9. [My favourite checker needs to load a configuration file from the project's root rather than the current directory...](#faqconfig)
|
|
|
|
4.10. [What is the difference between syntax checkers and style checkers?](#faqstyle)
|
|
|
|
4.11. [How can I check scripts written for different versions of Python?](#faqpython)
|
|
|
|
4.12. [How can I check scripts written for different versions of Ruby?](#faqruby)
|
|
|
|
4.13. [The `perl` checker has stopped working...](#faqperl)
|
|
|
|
4.14. [What happened to the `rustc` checker?](#faqrust)
|
|
|
|
4.15. [What happened to the `tsc` checker?](#faqtsc)
|
|
|
|
4.16. [What happened to the `xcrun` checker?](#faqxcrun)
|
2015-01-06 01:20:50 -05:00
|
|
|
5. [Resources](#otherresources)
|
2014-12-04 04:05:12 -05:00
|
|
|
|
2014-02-03 01:23:00 -05:00
|
|
|
- - -
|
2011-12-27 14:04:35 -05:00
|
|
|
|
2014-02-03 01:23:00 -05:00
|
|
|
<a name="introduction"></a>
|
|
|
|
|
|
|
|
## 1\. Introduction
|
2011-12-27 14:04:35 -05:00
|
|
|
|
2016-11-14 00:40:16 -05:00
|
|
|
Syntastic is a syntax checking plugin for [Vim][vim] created by
|
|
|
|
[Martin Grenfell][scrooloose]. It runs files through external syntax checkers
|
|
|
|
and displays any resulting errors to the user. This can be done on demand, or
|
|
|
|
automatically as files are saved. If syntax errors are detected, the user is
|
|
|
|
notified and is happy because they didn't have to compile their code or execute
|
|
|
|
their script to find them.
|
2011-12-27 14:04:35 -05:00
|
|
|
|
2016-07-31 11:45:34 -04:00
|
|
|
At the time of this writing, syntastic has checking plugins for ACPI
|
|
|
|
Source Language, ActionScript, Ada, Ansible configurations, API Blueprint,
|
2017-04-26 04:37:35 -04:00
|
|
|
AppleScript, AsciiDoc, Assembly languages, BEMHTML, Bro, Bourne shell, C, C++,
|
|
|
|
C#, Cabal, Chef, CMake, CoffeeScript, Coco, Coq, CSS, Cucumber, CUDA, D, Dart,
|
2016-07-31 11:45:34 -04:00
|
|
|
DocBook, Dockerfile, Dust, Elixir, Erlang, eRuby, Fortran, Gentoo metadata,
|
2017-09-02 00:41:39 -04:00
|
|
|
GLSL, Go, Haml, Haskell, Haxe, Handlebars, HSS, HTML, Java, JavaScript,
|
|
|
|
JSON, JSX, Julia, LESS, Lex, Limbo, LISP, LLVM intermediate language, Lua,
|
|
|
|
Markdown, MATLAB, Mercury, NASM, Nix, Objective-C, Objective-C++, OCaml, Perl,
|
|
|
|
Perl POD, PHP, gettext Portable Object, OS X and iOS property lists, Pug
|
|
|
|
(formerly Jade), Puppet, Python, QML, R, Racket, RDF TriG, RDF Turtle, Relax
|
|
|
|
NG, reStructuredText, RPM spec, Ruby, SASS/SCSS, Scala, Slim, SML, Solidity,
|
|
|
|
Sphinx, SQL, Stylus, Tcl, TeX, Texinfo, Twig, TypeScript, Vala, Verilog, VHDL,
|
|
|
|
Vim help, VimL, Vue.js, xHtml, XML, XSLT, XQuery, YACC, YAML, YANG data models,
|
|
|
|
z80, Zope page templates, and Zsh. See the [manual][checkers] for details about
|
|
|
|
the corresponding supported checkers (`:help syntastic-checkers` in Vim).
|
2015-02-23 08:59:38 -05:00
|
|
|
|
2016-07-26 14:34:04 -04:00
|
|
|
A number of third-party Vim plugins also provide checkers for syntastic, for
|
|
|
|
example: [merlin][merlin], [omnisharp-vim][omnisharp], [rust.vim][rust],
|
|
|
|
[syntastic-extras][myint], [syntastic-more][roktas], [tsuquyomi][tsuquyomi],
|
|
|
|
[vim-crystal][crystal], [vim-eastwood][eastwood], and [vim-swift][swift].
|
2011-12-27 14:04:35 -05:00
|
|
|
|
|
|
|
Below is a screenshot showing the methods that Syntastic uses to display syntax
|
2016-03-08 00:27:18 -05:00
|
|
|
errors. Note that, in practise, you will only have a subset of these methods
|
2011-12-27 14:04:35 -05:00
|
|
|
enabled.
|
|
|
|
|
2016-06-12 04:33:25 -04:00
|
|
|
![Screenshot 1][screenshot]
|
2011-12-27 14:04:35 -05:00
|
|
|
|
2011-12-27 14:13:27 -05:00
|
|
|
1. Errors are loaded into the location list for the corresponding window.
|
|
|
|
2. When the cursor is on a line containing an error, the error message is echoed in the command window.
|
|
|
|
3. Signs are placed beside lines with errors - note that warnings are displayed in a different color.
|
|
|
|
4. There is a configurable statusline flag you can include in your statusline config.
|
|
|
|
5. Hover the mouse over a line containing an error and the error message is displayed as a balloon.
|
|
|
|
6. (not shown) Highlighting errors with syntax highlighting. Erroneous parts of lines can be highlighted.
|
2011-11-30 15:56:43 -05:00
|
|
|
|
2014-02-03 01:23:00 -05:00
|
|
|
<a name="installation"></a>
|
|
|
|
|
|
|
|
## 2\. Installation
|
2011-11-30 15:56:43 -05:00
|
|
|
|
2014-10-16 05:09:10 -04:00
|
|
|
<a name="requirements"></a>
|
2014-03-04 04:13:43 -05:00
|
|
|
|
2014-10-16 05:09:10 -04:00
|
|
|
### 2.1\. Requirements
|
|
|
|
|
|
|
|
Syntastic itself has rather relaxed requirements: it doesn't have any external
|
2016-06-12 04:33:25 -04:00
|
|
|
dependencies, and it needs a version of [Vim][vim] compiled with a few common
|
2014-10-16 05:09:10 -04:00
|
|
|
features: `autocmd`, `eval`, `file_in_path`, `modify_fname`, `quickfix`,
|
2017-02-28 00:13:50 -05:00
|
|
|
`reltime`, `statusline`, and `user_commands`. Not all possible combinations of
|
|
|
|
features that include the ones above make equal sense on all operating systems,
|
|
|
|
but Vim version 7 or later with the "normal", "big", or "huge" feature sets
|
|
|
|
should be fine.
|
2014-10-16 05:09:10 -04:00
|
|
|
|
2014-10-16 08:18:54 -04:00
|
|
|
Syntastic should work with any modern plugin managers for Vim, such as
|
2016-09-12 12:59:11 -04:00
|
|
|
[NeoBundle][neobundle], [Pathogen][pathogen], [Vim-Addon-Manager][vam],
|
|
|
|
[Vim-Plug][plug], or [Vundle][vundle]. Instructions for installing syntastic
|
|
|
|
with [Pathogen][pathogen] are included below for completeness.
|
2014-10-16 05:09:10 -04:00
|
|
|
|
2016-03-06 16:16:57 -05:00
|
|
|
Starting with Vim version 7.4.1486 you can also load syntastic using the
|
|
|
|
standard mechanism of packages, without the help of third-party plugin managers
|
2016-03-08 00:27:18 -05:00
|
|
|
(see `:help packages` in Vim for details). Beware however that, while support
|
|
|
|
for packages has been added in Vim 7.4.1384, the functionality needed by
|
|
|
|
syntastic is present only in versions 7.4.1486 and later.
|
2016-03-06 16:16:57 -05:00
|
|
|
|
2014-10-16 05:09:10 -04:00
|
|
|
Last but not least: syntastic doesn't know how to do any syntax checks by
|
2014-10-16 08:18:54 -04:00
|
|
|
itself. In order to get meaningful results you need to install external
|
|
|
|
checkers corresponding to the types of files you use. Please consult the
|
2016-06-12 04:33:25 -04:00
|
|
|
[manual][checkers] (`:help syntastic-checkers` in Vim) for a list of supported
|
|
|
|
checkers.
|
2014-10-16 05:09:10 -04:00
|
|
|
|
|
|
|
<a name="installpathogen"></a>
|
|
|
|
|
|
|
|
### 2.2\. Installing syntastic with Pathogen
|
|
|
|
|
2016-06-12 04:33:25 -04:00
|
|
|
If you already have [Pathogen][pathogen] working then skip [Step 1](#step1) and go to
|
2014-10-16 05:09:10 -04:00
|
|
|
[Step 2](#step2).
|
2012-09-03 12:43:05 -04:00
|
|
|
|
2014-02-03 01:23:00 -05:00
|
|
|
<a name="step1"></a>
|
|
|
|
|
2014-10-16 05:09:10 -04:00
|
|
|
#### 2.2.1\. Step 1: Install pathogen.vim
|
2012-09-03 12:43:05 -04:00
|
|
|
|
2016-06-12 04:33:25 -04:00
|
|
|
First I'll show you how to install Tim Pope's [Pathogen][pathogen] so that it's easy to
|
2016-03-08 00:27:18 -05:00
|
|
|
install syntastic. Do this in your terminal so that you get the `pathogen.vim`
|
2014-03-04 04:13:43 -05:00
|
|
|
file and the directories it needs:
|
|
|
|
```sh
|
2014-05-27 04:40:15 -04:00
|
|
|
mkdir -p ~/.vim/autoload ~/.vim/bundle && \
|
|
|
|
curl -LSso ~/.vim/autoload/pathogen.vim https://tpo.pe/pathogen.vim
|
2014-03-04 04:13:43 -05:00
|
|
|
```
|
|
|
|
Next you *need* to add this to your `~/.vimrc`:
|
|
|
|
```vim
|
|
|
|
execute pathogen#infect()
|
|
|
|
```
|
2012-09-03 12:43:05 -04:00
|
|
|
|
2014-02-03 01:23:00 -05:00
|
|
|
<a name="step2"></a>
|
|
|
|
|
2014-10-16 05:09:10 -04:00
|
|
|
#### 2.2.2\. Step 2: Install syntastic as a Pathogen bundle
|
2012-09-03 12:43:05 -04:00
|
|
|
|
2014-03-04 04:13:43 -05:00
|
|
|
You now have pathogen installed and can put syntastic into `~/.vim/bundle` like
|
|
|
|
this:
|
|
|
|
```sh
|
2014-05-27 04:40:15 -04:00
|
|
|
cd ~/.vim/bundle && \
|
2016-11-14 00:40:16 -05:00
|
|
|
git clone --depth=1 https://github.com/vim-syntastic/syntastic.git
|
2014-03-04 04:13:43 -05:00
|
|
|
```
|
2012-09-03 12:43:05 -04:00
|
|
|
Quit vim and start it back up to reload it, then type:
|
2014-03-04 04:13:43 -05:00
|
|
|
```vim
|
|
|
|
:Helptags
|
|
|
|
```
|
|
|
|
If you get an error when you do this, then you probably didn't install
|
2016-06-12 04:33:25 -04:00
|
|
|
[Pathogen][pathogen] right. Go back to [Step 1](#step1) and make sure you did the
|
2014-10-16 05:09:10 -04:00
|
|
|
following:
|
2012-09-03 12:43:05 -04:00
|
|
|
|
2014-03-04 04:13:43 -05:00
|
|
|
1. Created both the `~/.vim/autoload` and `~/.vim/bundle` directories.
|
2015-01-04 01:57:34 -05:00
|
|
|
2. Added the `execute pathogen#infect()` line to your `~/.vimrc` file
|
2014-03-04 04:13:43 -05:00
|
|
|
3. Did the `git clone` of syntastic inside `~/.vim/bundle`
|
2012-09-03 12:43:05 -04:00
|
|
|
4. Have permissions to access all of these directories.
|
2011-12-13 03:54:12 -05:00
|
|
|
|
2015-01-06 01:20:50 -05:00
|
|
|
<a name="settings"></a>
|
|
|
|
|
|
|
|
## 3\. Recommended settings
|
|
|
|
|
2015-08-14 05:03:19 -04:00
|
|
|
Syntastic has numerous options that can be configured, and the defaults
|
2016-03-08 00:27:18 -05:00
|
|
|
are not particularly well suitable for new users. It is recommended
|
2015-08-14 05:03:19 -04:00
|
|
|
that you start by adding the following lines to your `vimrc` file, and
|
|
|
|
return to them after reading the manual (see `:help syntastic` in Vim):
|
2015-01-06 01:20:50 -05:00
|
|
|
```vim
|
|
|
|
set statusline+=%#warningmsg#
|
|
|
|
set statusline+=%{SyntasticStatuslineFlag()}
|
|
|
|
set statusline+=%*
|
|
|
|
|
|
|
|
let g:syntastic_always_populate_loc_list = 1
|
|
|
|
let g:syntastic_auto_loc_list = 1
|
|
|
|
let g:syntastic_check_on_open = 1
|
|
|
|
let g:syntastic_check_on_wq = 0
|
|
|
|
```
|
2011-12-13 03:54:12 -05:00
|
|
|
|
2014-02-03 01:23:00 -05:00
|
|
|
<a name="faq"></a>
|
|
|
|
|
2015-01-06 01:20:50 -05:00
|
|
|
## 4\. FAQ
|
2012-03-01 11:54:05 -05:00
|
|
|
|
2014-04-02 15:47:09 -04:00
|
|
|
<a name="faqinfo"></a>
|
|
|
|
|
2015-01-06 01:20:50 -05:00
|
|
|
__4.1. Q. I installed syntastic but it isn't reporting any errors...__
|
2012-03-01 11:54:05 -05:00
|
|
|
|
2014-01-20 03:29:06 -05:00
|
|
|
A. The most likely reason is that none of the syntax checkers that it requires
|
2016-04-11 12:08:21 -04:00
|
|
|
are installed. For example: by default, python requires either `flake8` or
|
2016-06-12 04:33:25 -04:00
|
|
|
`pylint` to be installed and in your `$PATH`. Read the [manual][checkers]
|
|
|
|
(`:help syntastic-checkers` in Vim) to find out what executables are
|
|
|
|
supported. Note that aliases do not work; the actual executables must be
|
|
|
|
available in your `$PATH`. Symbolic links are okay though. You can see
|
|
|
|
syntastic's idea of available checkers by running `:SyntasticInfo`.
|
2012-03-01 11:54:05 -05:00
|
|
|
|
2015-02-23 02:06:01 -05:00
|
|
|
A second probable reason is that none of the available checkers are
|
|
|
|
enabled. Syntastic comes preconfigured with a default list of enabled checkers
|
|
|
|
per filetype, but this list is kept short in order to prevent slowing down Vim
|
|
|
|
or trying to run conflicting checks. The command `:SyntasticInfo` will show you
|
|
|
|
which checkers are enabled. You can tell syntastic which checkers (among the
|
|
|
|
available ones) you want to run by setting `g:syntastic_<filetype>_checkers` in
|
|
|
|
your `vimrc` (see [below](#faqcheckers)).
|
2015-02-22 12:03:44 -05:00
|
|
|
|
2015-03-14 01:29:06 -04:00
|
|
|
A third possible reason is that the `$PATH` seen by syntastic might not be same
|
|
|
|
as the `$PATH` in your login shell. Syntastic runs checkers using the shell
|
|
|
|
pointed to by Vim's `shell` (or by `g:syntastic_shell`, if set), and that's the
|
2015-03-14 01:32:43 -04:00
|
|
|
shell you need to configure to set the proper `$PATH` and environment variables
|
2015-03-14 01:29:06 -04:00
|
|
|
for your checkers. You can see syntastic's idea of `$PATH` by running
|
|
|
|
```vim
|
|
|
|
:echo syntastic#util#system('echo "$PATH"')
|
|
|
|
```
|
|
|
|
on UNIX and Mac OS-X systems, or
|
|
|
|
```vim
|
|
|
|
:echo syntastic#util#system('echo %PATH%')
|
|
|
|
```
|
|
|
|
on Windows.
|
|
|
|
|
2015-03-14 01:32:43 -04:00
|
|
|
Finally, another reason it could fail is that either the command line options
|
|
|
|
or the error output for a syntax checker may have changed. In this case, make
|
|
|
|
sure you have the latest version of the syntax checker installed. If it still
|
2016-06-12 04:33:25 -04:00
|
|
|
fails then post an [issue][bug_tracker] - or better yet, create a pull request.
|
2012-03-01 11:54:05 -05:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
<a name="faqcheckers"></a>
|
2016-07-08 13:11:03 -04:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
__4.2. Q. Syntastic supports several checkers for my filetype, how do I tell it
|
|
|
|
which one(s) to use?__
|
2014-08-24 13:44:07 -04:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
A. Add a line like this to your `vimrc`:
|
|
|
|
```vim
|
|
|
|
let g:syntastic_<filetype>_checkers = ['<checker-name>']
|
|
|
|
```
|
2014-11-20 08:43:58 -05:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
To see the list of supported checkers for your filetype read the
|
|
|
|
[manual][checkers] (`:help syntastic-checkers` in Vim).
|
2014-11-20 08:43:58 -05:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
For example, Python has the following checkers, among others: `flake8`,
|
|
|
|
`pyflakes`, `pylint` and a native `python` checker. To tell syntastic to use
|
|
|
|
`pylint`, you would use this setting:
|
2015-03-10 09:58:56 -04:00
|
|
|
```vim
|
2016-08-31 03:14:03 -04:00
|
|
|
let g:syntastic_python_checkers = ['pylint']
|
2014-12-04 03:13:53 -05:00
|
|
|
```
|
2016-08-31 03:14:03 -04:00
|
|
|
|
|
|
|
Checkers can be chained together like this:
|
2014-12-04 03:13:53 -05:00
|
|
|
```vim
|
2016-08-31 03:14:03 -04:00
|
|
|
let g:syntastic_php_checkers = ['php', 'phpcs', 'phpmd']
|
2014-12-04 03:13:53 -05:00
|
|
|
```
|
2014-11-20 08:43:58 -05:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
This is telling syntastic to run the `php` checker first, and if no errors are
|
|
|
|
found, run `phpcs`, and then `phpmd`.
|
2014-03-03 02:43:14 -05:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
You can also run checkers explicitly by calling `:SyntasticCheck <checker>`.
|
|
|
|
For example to run `phpcs` and `phpmd`:
|
2014-03-03 02:43:14 -05:00
|
|
|
```vim
|
2016-08-31 03:14:03 -04:00
|
|
|
:SyntasticCheck phpcs phpmd
|
2014-03-03 02:43:14 -05:00
|
|
|
```
|
2013-02-14 09:58:47 -05:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
This works for any checkers available for the current filetype, even if they
|
2016-10-09 04:08:06 -04:00
|
|
|
aren't listed in `g:syntastic_<filetype>_checkers`.
|
|
|
|
|
|
|
|
<a name="faqforeign"></a>
|
|
|
|
|
2016-10-10 15:57:17 -04:00
|
|
|
__4.3. Q. How can I run checkers for "foreign" filetypes against the current
|
2016-10-09 04:08:06 -04:00
|
|
|
file?__
|
|
|
|
|
|
|
|
A. You need to qualify the name of the "foreign" checker with the name
|
|
|
|
of its filetype. For example to check `tex` files with the checker
|
|
|
|
`language_check` (which normally acts only on files of type `text`), you can
|
|
|
|
add `text/language_check` to the list fo checkers for `tex`:
|
|
|
|
```vim
|
|
|
|
let g:syntastic_tex_checkers = ['lacheck', 'text/language_check']
|
|
|
|
```
|
|
|
|
|
|
|
|
This also works with `:SyntasticCheck`, e.g. the following command runs
|
|
|
|
`text/language_check` against the current file regardless of the current
|
|
|
|
filetype:
|
|
|
|
```vim
|
|
|
|
:SyntasticCheck text/language_check
|
|
|
|
```
|
|
|
|
|
|
|
|
Of course, the checkers specified this way need to be known to syntastic, and
|
|
|
|
they need to be shown as available when you run `:SyntasticInfo`. You can't
|
|
|
|
just make up a combination of a filetype and a program name and expect it to
|
|
|
|
work as a checker.
|
2014-06-12 17:23:10 -04:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
<a name="faqaggregate"></a>
|
2014-06-12 17:23:10 -04:00
|
|
|
|
2016-10-09 04:08:06 -04:00
|
|
|
__4.4. Q. I have enabled multiple checkers for the current filetype. How can I
|
2016-08-31 03:14:03 -04:00
|
|
|
display all errors from all checkers together?__
|
2014-06-12 17:23:10 -04:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
A. Set `g:syntastic_aggregate_errors` to 1 in your `vimrc`:
|
|
|
|
```vim
|
|
|
|
let g:syntastic_aggregate_errors = 1
|
|
|
|
```
|
2016-07-26 14:34:04 -04:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
See `:help syntastic-aggregating-errors` for more details.
|
2016-07-26 14:34:04 -04:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
<a name="faqargs"></a>
|
2016-07-26 14:34:04 -04:00
|
|
|
|
2016-10-09 04:08:06 -04:00
|
|
|
__4.5. Q. How can I pass additional arguments to a checker?__
|
2015-02-20 15:15:09 -05:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
A. In most cases a command line is constructed using an internal function
|
|
|
|
named `makeprgBuild()`, which provides a number of options that allow you to
|
|
|
|
customise every part of the command that gets run. You can set these options
|
|
|
|
using global variables.
|
2015-02-20 15:15:09 -05:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
The general form of the global `args` variable is
|
|
|
|
`syntastic_<filetype>_<checker>_args`. Thus if you wanted to pass
|
|
|
|
`--my --args --here` to the Ruby `mri` checker you would add this line to your
|
|
|
|
`vimrc`:
|
|
|
|
```vim
|
|
|
|
let g:syntastic_ruby_mri_args = "--my --args --here"
|
|
|
|
```
|
|
|
|
|
|
|
|
See `:help syntastic-checker-options` for more information.
|
|
|
|
|
|
|
|
A number of checkers don't use the `makeprgBuild()` function mentioned above,
|
|
|
|
or have additional options that can be configured. For these checkers the exact
|
|
|
|
list of options should be included in the [manual][checkers]
|
|
|
|
(`:help syntastic-checkers` in Vim).
|
2015-02-20 15:15:09 -05:00
|
|
|
|
2014-04-02 15:47:09 -04:00
|
|
|
<a name="faqloclist"></a>
|
|
|
|
|
2016-10-09 04:08:06 -04:00
|
|
|
__4.6. Q. I run a checker and the location list is not updated...__
|
|
|
|
__4.6. Q. I run`:lopen` or `:lwindow` and the error window is empty...__
|
2013-02-21 21:04:25 -05:00
|
|
|
|
2014-03-04 04:13:43 -05:00
|
|
|
A. By default the location list is changed only when you run the `:Errors`
|
2016-03-08 00:27:18 -05:00
|
|
|
command, in order to minimise conflicts with other plugins. If you want the
|
2014-01-20 03:29:06 -05:00
|
|
|
location list to always be updated when you run the checkers, add this line to
|
2015-01-06 01:20:50 -05:00
|
|
|
your `vimrc`:
|
2013-05-27 03:20:44 -04:00
|
|
|
```vim
|
2014-03-04 04:13:43 -05:00
|
|
|
let g:syntastic_always_populate_loc_list = 1
|
2013-05-27 03:20:44 -04:00
|
|
|
```
|
2013-02-21 21:04:25 -05:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
<a name="faqlnext"></a>
|
2013-02-21 21:04:25 -05:00
|
|
|
|
2016-10-09 04:08:06 -04:00
|
|
|
__4.7. Q. How can I jump between the different errors without using the location
|
2016-08-31 03:14:03 -04:00
|
|
|
list at the bottom of the window?__
|
2013-02-21 21:04:25 -05:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
A. Vim provides several built-in commands for this. See `:help :lnext` and
|
|
|
|
`:help :lprevious`.
|
2013-02-21 21:04:25 -05:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
If you use these commands a lot then you may want to add shortcut mappings to
|
|
|
|
your `vimrc`, or install something like [unimpaired][unimpaired], which provides such
|
|
|
|
mappings (among other things).
|
2013-02-21 21:04:25 -05:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
<a name="faqbdelete"></a>
|
2014-04-02 15:47:09 -04:00
|
|
|
|
2016-10-09 04:08:06 -04:00
|
|
|
__4.8. Q. The error window is closed automatically when I `:quit` the current buffer
|
2016-09-12 12:59:11 -04:00
|
|
|
but not when I `:bdelete` it?__
|
2013-02-10 11:51:02 -05:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
A. There is no safe way to handle that situation automatically, but you can
|
|
|
|
work around it:
|
2013-05-27 03:20:44 -04:00
|
|
|
```vim
|
2016-08-31 03:14:03 -04:00
|
|
|
nnoremap <silent> <C-d> :lclose<CR>:bdelete<CR>
|
|
|
|
cabbrev <silent> bd <C-r>=(getcmdtype()==#':' && getcmdpos()==1 ? 'lclose\|bdelete' : 'bd')<CR>
|
2013-05-27 03:20:44 -04:00
|
|
|
```
|
2013-02-10 11:51:02 -05:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
<a name="faqconfig"></a>
|
2013-02-10 11:51:02 -05:00
|
|
|
|
2016-10-09 04:08:06 -04:00
|
|
|
__4.9. My favourite checker needs to load a configuration file from the
|
2016-08-31 03:14:03 -04:00
|
|
|
project's root rather than the current directory...__
|
2013-02-10 11:51:02 -05:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
A. You can set up an `autocmd` to search for the configuration file in the
|
|
|
|
current directory and upwards, and add it to the checker's options when found.
|
|
|
|
For example for `jscs`:
|
2013-02-10 11:51:02 -05:00
|
|
|
|
2013-05-27 03:20:44 -04:00
|
|
|
```vim
|
2016-08-31 03:14:03 -04:00
|
|
|
function! FindConfig(prefix, what, where)
|
|
|
|
let cfg = findfile(a:what, escape(a:where, ' ') . ';')
|
|
|
|
return cfg !=# '' ? ' ' . a:prefix . ' ' . shellescape(cfg) : ''
|
|
|
|
endfunction
|
2014-04-14 01:43:12 -04:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
autocmd FileType javascript let b:syntastic_javascript_jscs_args =
|
|
|
|
\ get(g:, 'syntastic_javascript_jscs_args', '') .
|
|
|
|
\ FindConfig('-c', '.jscsrc', expand('<afile>:p:h', 1))
|
2014-04-14 01:43:12 -04:00
|
|
|
```
|
|
|
|
|
2014-09-17 13:22:28 -04:00
|
|
|
<a name="faqstyle"></a>
|
|
|
|
|
2016-10-09 04:08:06 -04:00
|
|
|
__4.10. Q. What is the difference between syntax checkers and style checkers?__
|
2014-09-17 13:22:28 -04:00
|
|
|
|
2014-09-17 16:19:04 -04:00
|
|
|
A. The errors and warnings they produce are highlighted differently and can
|
2014-09-17 13:22:28 -04:00
|
|
|
be filtered by different rules, but otherwise the distinction is pretty much
|
2014-09-19 01:20:30 -04:00
|
|
|
arbitrary. There is an ongoing effort to keep things consistent, so you can
|
|
|
|
_generally_ expect messages produced by syntax checkers to be _mostly_ related
|
|
|
|
to syntax, and messages produced by style checkers to be _mostly_ about style.
|
|
|
|
But there can be no formal guarantee that, say, a style checker that runs into
|
|
|
|
a syntax error wouldn't die with a fatal message, nor that a syntax checker
|
|
|
|
wouldn't give you warnings against using some constructs as being bad practice.
|
2016-08-31 03:14:03 -04:00
|
|
|
There is also no guarantee that messages marked as `style` are less severe than
|
|
|
|
the ones marked as `syntax` (whatever that might mean). And there are even a
|
2014-09-19 01:20:30 -04:00
|
|
|
few Frankenstein checkers (for example `flake8` and `pylama`) that, by their
|
|
|
|
nature, produce both kinds of messages. Syntastic is not smart enough to be
|
|
|
|
able to sort out these things by itself.
|
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
Generally it's more useful to look at this from the perspective of filtering
|
2016-03-08 00:27:18 -05:00
|
|
|
unwanted messages, rather than as an indicator of severity levels. The
|
2014-09-19 01:20:30 -04:00
|
|
|
distinction between syntax and style is orthogonal to the distinction between
|
|
|
|
errors and warnings, and thus you can turn off messages based on level, on
|
|
|
|
type, or both.
|
|
|
|
|
|
|
|
e.g. To disable all style messages:
|
2014-09-17 13:22:28 -04:00
|
|
|
```vim
|
|
|
|
let g:syntastic_quiet_messages = { "type": "style" }
|
|
|
|
```
|
2016-08-31 03:14:03 -04:00
|
|
|
See `:help syntastic_quiet_messages` for more information.
|
2014-04-14 01:43:12 -04:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
<a name="faqpython"></a>
|
2014-04-14 01:43:12 -04:00
|
|
|
|
2016-10-09 04:08:06 -04:00
|
|
|
__4.11. Q. How can I check scripts written for different versions of Python?__
|
2014-04-14 01:43:12 -04:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
A. Install a Python version manager such as [virtualenv][virtualenv]
|
|
|
|
or [pyenv][pyenv], activate the environment for the relevant version
|
|
|
|
of Python, and install in it the checkers you want to use. Set
|
|
|
|
`g:syntastic_python_checkers` accordingly in your `vimrc`, and run [Vim][vim]
|
|
|
|
from the virtual environment.
|
2014-04-14 01:43:12 -04:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
If you're starting Vim from a desktop manager rather than from a terminal you
|
|
|
|
might need to write wrapper scripts around your checkers, to activate the
|
|
|
|
virtual environment before running the actual checks. Then you'll need to
|
|
|
|
point the relevant `g:syntastic_python_<checker>_exec` variables to the wrapper
|
|
|
|
scripts.
|
2014-04-02 15:47:09 -04:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
<a name="faqruby"></a>
|
2012-09-05 05:13:30 -04:00
|
|
|
|
2016-10-09 04:08:06 -04:00
|
|
|
__4.12. Q. How can I check scripts written for different versions of Ruby?__
|
2012-09-05 05:13:30 -04:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
A. Install a Ruby version manager such as [rvm][rvm] or [rbenv][rbenv],
|
2017-08-07 04:48:49 -04:00
|
|
|
activate the relevant version of Ruby, and install in it the checkers you want
|
|
|
|
to use. Set `g:syntastic_ruby_checkers` accordingly in your `vimrc`, and run
|
|
|
|
[Vim][vim] under the relevant Ruby version.
|
|
|
|
|
|
|
|
If you're starting Vim from a desktop manager rather than from a terminal
|
|
|
|
and depending on the version manager you use you might need to write wrapper
|
|
|
|
scripts around your checkers, to activate the relevant version of Ruby
|
|
|
|
before running the actual checks. Then you'll need to point the relevant
|
|
|
|
`g:syntastic_ruby_<checker>_exec` variables to the wrapper scripts.
|
2016-07-08 13:11:03 -04:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
<a name="faqperl"></a>
|
2016-07-08 13:11:03 -04:00
|
|
|
|
2016-10-09 04:08:06 -04:00
|
|
|
__4.13. Q. The `perl` checker has stopped working...__
|
2016-07-08 13:11:03 -04:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
A. The `perl` checker runs `perl -c` against your file, which in turn
|
|
|
|
__executes__ any `BEGIN`, `UNITCHECK`, and `CHECK` blocks, and any `use`
|
|
|
|
statements in your file (cf. [perlrun][perlrun]). This is probably fine if you
|
|
|
|
wrote the file yourself, but it's a security problem if you're checking
|
|
|
|
third-party files. Since there is currently no way to disable this behaviour
|
|
|
|
while still producing useful results, the checker is now disabled by default.
|
|
|
|
To (re-)enable it, make sure the `g:syntastic_perl_checkers` list includes
|
|
|
|
`perl`, and set `g:syntastic_enable_perl_checker` to 1 in your `vimrc`:
|
2016-07-08 13:11:03 -04:00
|
|
|
```vim
|
2016-08-31 03:14:03 -04:00
|
|
|
let g:syntastic_enable_perl_checker = 1
|
2016-07-08 13:11:03 -04:00
|
|
|
```
|
2014-04-02 15:47:09 -04:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
<a name="faqrust"></a>
|
2013-04-29 02:24:32 -04:00
|
|
|
|
2016-10-09 04:08:06 -04:00
|
|
|
__4.14. Q. What happened to the `rustc` checker?__
|
2013-04-29 02:24:32 -04:00
|
|
|
|
2016-08-31 03:14:03 -04:00
|
|
|
A. It is now part of the [rust.vim][rust] plugin. If you install this plugin the
|
|
|
|
checker should be picked up automatically by syntastic.
|
|
|
|
|
|
|
|
<a name="faqtsc"></a>
|
|
|
|
|
2016-10-09 04:08:06 -04:00
|
|
|
__4.15. Q. What happened to the `tsc` checker?__
|
2016-08-31 03:14:03 -04:00
|
|
|
|
|
|
|
A. It didn't meet people's expectations and it has been removed. The plugin
|
|
|
|
[tsuquyomi][tsuquyomi] comes packaged with a checker for TypeScript. If you
|
|
|
|
install this plugin the checker should be picked up automatically by syntastic.
|
|
|
|
|
|
|
|
<a name="faqxcrun"></a>
|
|
|
|
|
2016-10-09 04:08:06 -04:00
|
|
|
__4.16. Q. What happened to the `xcrun` checker?__
|
2016-08-31 03:14:03 -04:00
|
|
|
|
|
|
|
A. The `xcrun` checker used to have a security problem and it has been removed.
|
|
|
|
A better checker for __Swift__ is part of the [vim-swift][swift] plugin. If you
|
|
|
|
install this plugin the checker should be picked up automatically by syntastic.
|
2014-01-20 03:29:06 -05:00
|
|
|
|
2014-02-03 01:23:00 -05:00
|
|
|
<a name="otherresources"></a>
|
|
|
|
|
2015-01-06 01:20:50 -05:00
|
|
|
## 5\. Resources
|
2014-01-20 03:29:06 -05:00
|
|
|
|
|
|
|
The preferred place for posting suggestions, reporting bugs, and general
|
2016-06-12 04:33:25 -04:00
|
|
|
discussions related to syntastic is the [issue tracker at GitHub][bug_tracker].
|
|
|
|
A guide for writing syntax checkers can be found in the [wiki][guide].
|
|
|
|
There are also a dedicated [google group][google_group], and a
|
|
|
|
[syntastic tag at StackOverflow][stack_overflow].
|
2014-01-20 03:29:06 -05:00
|
|
|
|
|
|
|
Syntastic aims to provide a common interface to syntax checkers for as many
|
2016-03-08 00:27:18 -05:00
|
|
|
languages as possible. For particular languages, there are, of course, other
|
|
|
|
plugins that provide more functionality than syntastic. You might want to take
|
2016-06-12 04:33:25 -04:00
|
|
|
a look at [ghcmod-vim][ghcmod], [jedi-vim][jedi], [python-mode][python_mode], [vim-go][vimgo], or
|
|
|
|
[YouCompleteMe][ycm].
|
|
|
|
|
2016-11-14 00:40:16 -05:00
|
|
|
[scrooloose]: https://github.com/scrooloose
|
|
|
|
[screenshot]: https://github.com/vim-syntastic/syntastic/raw/master/_assets/screenshot_1.png
|
2016-06-12 04:33:25 -04:00
|
|
|
|
2016-11-14 00:40:16 -05:00
|
|
|
[bug_tracker]: https://github.com/vim-syntastic/syntastic/issues
|
|
|
|
[checkers]: https://github.com/vim-syntastic/syntastic/blob/master/doc/syntastic-checkers.txt
|
2016-06-12 04:33:25 -04:00
|
|
|
[crystal]: https://github.com/rhysd/vim-crystal
|
|
|
|
[eastwood]: https://github.com/venantius/vim-eastwood
|
|
|
|
[ghcmod]: https://github.com/eagletmt/ghcmod-vim
|
|
|
|
[google_group]: https://groups.google.com/group/vim-syntastic
|
2016-11-14 00:40:16 -05:00
|
|
|
[guide]: https://github.com/vim-syntastic/syntastic/wiki/Syntax-Checker-Guide
|
2016-06-12 04:33:25 -04:00
|
|
|
[jedi]: https://github.com/davidhalter/jedi-vim
|
|
|
|
[merlin]: https://github.com/the-lambda-church/merlin
|
|
|
|
[myint]: https://github.com/myint/syntastic-extras
|
|
|
|
[neobundle]: https://github.com/Shougo/neobundle.vim
|
|
|
|
[omnisharp]: https://github.com/OmniSharp/omnisharp-vim
|
|
|
|
[pathogen]: https://github.com/tpope/vim-pathogen
|
|
|
|
[perlrun]: http://perldoc.perl.org/perlrun.html#*-c*
|
|
|
|
[plug]: https://github.com/junegunn/vim-plug/
|
2016-07-08 13:11:03 -04:00
|
|
|
[pyenv]: https://github.com/yyuu/pyenv
|
2016-06-12 04:33:25 -04:00
|
|
|
[python_mode]: https://github.com/klen/python-mode
|
2016-07-08 13:11:03 -04:00
|
|
|
[rbenv]: https://github.com/rbenv/rbenv
|
2016-06-12 04:33:25 -04:00
|
|
|
[roktas]: https://github.com/roktas/syntastic-more
|
|
|
|
[rust]: https://github.com/rust-lang/rust.vim
|
2016-07-08 13:11:03 -04:00
|
|
|
[rvm]: https://rvm.io/
|
2016-06-12 04:33:25 -04:00
|
|
|
[stack_overflow]: http://stackoverflow.com/questions/tagged/syntastic
|
|
|
|
[swift]: https://github.com/kballard/vim-swift
|
2016-07-26 14:34:04 -04:00
|
|
|
[tsuquyomi]: https://github.com/Quramy/tsuquyomi/
|
2016-06-12 04:33:25 -04:00
|
|
|
[unimpaired]: https://github.com/tpope/vim-unimpaired
|
|
|
|
[vam]: https://github.com/MarcWeber/vim-addon-manager
|
|
|
|
[vim]: http://www.vim.org/
|
|
|
|
[vimgo]: https://github.com/fatih/vim-go
|
2016-07-08 13:11:03 -04:00
|
|
|
[virtualenv]: https://virtualenv.pypa.io/en/stable/
|
2016-06-12 04:33:25 -04:00
|
|
|
[vnu]: http://about.validator.nu/
|
|
|
|
[vnu_jar]: https://github.com/validator/validator/releases/latest
|
|
|
|
[vnu_server]: http://validator.github.io/validator/#standalone
|
|
|
|
[vundle]: https://github.com/gmarik/Vundle.vim
|
|
|
|
[ycm]: http://valloric.github.io/YouCompleteMe/
|
2014-09-19 01:20:30 -04:00
|
|
|
|
|
|
|
<!--
|
|
|
|
vim:tw=79:sw=4:
|
|
|
|
-->
|