Permalink
7279 lines (4997 sloc) 257 KB
*syntastic-checkers.txt* Syntastic checkers
*syntastic-checkers*
==============================================================================
SYNTAX CHECKERS BY LANGUAGE *syntastic-checkers-lang*
|syntastic| comes with checkers for the following languages:
ACPI Source Language.....................|syntastic-checkers-asl|
ActionScript.............................|syntastic-checkers-actionscript|
Ada......................................|syntastic-checkers-ada|
Ansible..................................|syntastic-checkers-ansible|
API Blueprint............................|syntastic-checkers-apiblueprint|
AppleScript..............................|syntastic-checkers-applescript|
AsciiDoc.................................|syntastic-checkers-asciidoc|
Assembly Languages.......................|syntastic-checkers-asm|
BEMHTML..................................|syntastic-checkers-bemhtml|
Bro......................................|syntastic-checkers-bro|
C........................................|syntastic-checkers-c|
C#.......................................|syntastic-checkers-cs|
C++......................................|syntastic-checkers-cpp|
Cabal....................................|syntastic-checkers-cabal|
Chef.....................................|syntastic-checkers-chef|
COBOL....................................|syntastic-checkers-cobol|
Coco.....................................|syntastic-checkers-co|
CoffeeScript.............................|syntastic-checkers-coffee|
Coq......................................|syntastic-checkers-coq|
CSS......................................|syntastic-checkers-css|
Cucumber.................................|syntastic-checkers-cucumber|
CUDA.....................................|syntastic-checkers-cuda|
D........................................|syntastic-checkers-d|
Dart.....................................|syntastic-checkers-dart|
DocBook..................................|syntastic-checkers-docbk|
Dockerfile...............................|syntastic-checkers-dockerfile|
Dust.....................................|syntastic-checkers-dustjs|
Elixir...................................|syntastic-checkers-elixir|
Erlang...................................|syntastic-checkers-erlang|
eRuby....................................|syntastic-checkers-eruby|
Fortran..................................|syntastic-checkers-fortran|
Gentoo Metadata..........................|syntastic-checkers-gentoo|
Gettext PO...............................|syntastic-checkers-po|
GLSL.....................................|syntastic-checkers-glsl|
Go.......................................|syntastic-checkers-go|
Haml.....................................|syntastic-checkers-haml|
Handlebars...............................|syntastic-checkers-handlebars|
Haskell..................................|syntastic-checkers-haskell|
Haxe.....................................|syntastic-checkers-haxe|
HSS......................................|syntastic-checkers-hss|
HTML.....................................|syntastic-checkers-html|
Java.....................................|syntastic-checkers-java|
JavaScript...............................|syntastic-checkers-javascript|
JSON.....................................|syntastic-checkers-json|
LESS.....................................|syntastic-checkers-less|
Lex......................................|syntastic-checkers-lex|
Limbo....................................|syntastic-checkers-limbo|
LISP.....................................|syntastic-checkers-lisp|
LLVM.....................................|syntastic-checkers-llvm|
Lua......................................|syntastic-checkers-lua|
Markdown.................................|syntastic-checkers-markdown|
MATLAB...................................|syntastic-checkers-matlab|
Mercury..................................|syntastic-checkers-mercury|
NASM.....................................|syntastic-checkers-nasm|
Nix......................................|syntastic-checkers-nix|
nroff....................................|syntastic-checkers-nroff|
Objective-C..............................|syntastic-checkers-objc|
Objective-C++............................|syntastic-checkers-objcpp|
OCaml....................................|syntastic-checkers-ocaml|
Perl.....................................|syntastic-checkers-perl|
PHP......................................|syntastic-checkers-php|
POD......................................|syntastic-checkers-pod|
Pug (formerly Jade)......................|syntastic-checkers-pug|
Puppet...................................|syntastic-checkers-puppet|
Python...................................|syntastic-checkers-python|
QML......................................|syntastic-checkers-qml|
R........................................|syntastic-checkers-r|
R Markdown...............................|syntastic-checkers-rmd|
Racket...................................|syntastic-checkers-racket|
Relax NG.................................|syntastic-checkers-rnc|
reStructuredText.........................|syntastic-checkers-rst|
RPM spec.................................|syntastic-checkers-spec|
Ruby.....................................|syntastic-checkers-ruby|
SASS.....................................|syntastic-checkers-sass|
Scala....................................|syntastic-checkers-scala|
SCSS.....................................|syntastic-checkers-scss|
Sh.......................................|syntastic-checkers-sh|
Slim.....................................|syntastic-checkers-slim|
SML......................................|syntastic-checkers-sml|
Solidity.................................|syntastic-checkers-solidity|
SQL......................................|syntastic-checkers-sql|
Stylus...................................|syntastic-checkers-stylus|
Tcl......................................|syntastic-checkers-tcl|
TeX......................................|syntastic-checkers-tex|
Texinfo..................................|syntastic-checkers-texinfo|
Text.....................................|syntastic-checkers-text|
Turtle...................................|syntastic-checkers-turtle|
TriG.....................................|syntastic-checkers-trig|
Twig.....................................|syntastic-checkers-twig|
TypeScript...............................|syntastic-checkers-typescript|
Vala.....................................|syntastic-checkers-vala|
Verilog..................................|syntastic-checkers-verilog|
VHDL.....................................|syntastic-checkers-vhdl|
Vim help.................................|syntastic-checkers-help|
VimL.....................................|syntastic-checkers-vim|
xHTML....................................|syntastic-checkers-xhtml|
XML......................................|syntastic-checkers-xml|
XQuery...................................|syntastic-checkers-xquery|
XSLT.....................................|syntastic-checkers-xslt|
YACC.....................................|syntastic-checkers-yacc|
YAML.....................................|syntastic-checkers-yaml|
YANG.....................................|syntastic-checkers-yang|
Z80......................................|syntastic-checkers-z80|
Zope Page Templates......................|syntastic-checkers-zpt|
Zsh......................................|syntastic-checkers-zsh|
Third-party checkers are available for additional languages.
==============================================================================
SYNTAX CHECKERS FOR ACPI SOURCE LANGUAGE *syntastic-checkers-asl*
The following checkers are available for the ACPI Source Language (filetype
"asl"):
1. iasl.....................|syntastic-asl-iasl|
------------------------------------------------------------------------------
1. iasl *syntastic-asl-iasl*
Name: iasl
Maintainer: Peter Wu <peter@lekensteyn.nl>
"iasl" is a compiler/decompiler for ACPI Source Language (ASL) and ACPI
Machine Language (AML). See the project's page for details:
https://acpica.org/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Note~
You probably also need a plugin to set |filetype| for ASL files, such as
"vim-acpi-asl":
https://github.com/martinlroth/vim-acpi-asl
==============================================================================
SYNTAX CHECKERS FOR ACTIONSCRIPT *syntastic-checkers-actionscript*
The following checkers are available for ActionScript (filetype
"actionscript"):
1. mxmlc....................|syntastic-actionscript-mxmlc|
------------------------------------------------------------------------------
1. mxmlc *syntastic-actionscript-mxmlc*
Name: mxmlc
Maintainer: Andy Earnshaw <andyearnshaw@gmail.com>
"mxmlc" is a compiler for ActionScript. See Apache Flex for details:
http://flex.apache.org/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
==============================================================================
SYNTAX CHECKERS FOR ADA *syntastic-checkers-ada*
The following checkers are available for Ada (filetype "ada"):
1. GCC......................|syntastic-ada-gcc|
------------------------------------------------------------------------------
1. GCC *syntastic-ada-gcc*
Name: gcc
Maintainer: Alfredo Di Napoli <alfredo.dinapoli@gmail.com>
Checker options~
*'g:syntastic_ada_compiler'*
Type: string
Default: "gcc"
Compiler executable.
*'g:syntastic_ada_errorformat'*
Type: string
Default: unset
Override for the default |'errorformat'|.
*'g:syntastic_ada_remove_include_errors'*
Type: boolean
Default: 0
By default, errors in files included from the file being checked are shown.
Set this variable to 1 to remove messages about errors in included files.
Please note that this means syntastic will silently abort checks if there are
fatal errors in one of the included files.
*'g:syntastic_ada_compiler_options'*
Type: string
Default: unset
Compilation flags (such as defines or include directories) to be passed to the
checker.
*'g:syntastic_ada_config_file'*
Type: string
Default: ".syntastic_ada_config"
File containing additional compilation flags to be passed to the checker, one
option per line (cf. |syntastic-config-files|).
*'g:syntastic_ada_include_dirs'*
Type: array of strings
Default: []
Include directories to be passed to the checker, in addition to the above
compilation flags. You can set it like this: >
let g:syntastic_ada_include_dirs = ["includes", "headers"]
<
and the corresponding "-Iincludes -Iheaders" will be added to the compilation
flags.
*'b:syntastic_ada_cflags'*
Type: string
Default: unset
Buffer-local variable. Additional compilation flags specific to the current
buffer.
*'g:syntastic_ada_check_header'*
Type: boolean
Default: 0
If the current file is a header (namely if its extension is "ads"), all checks
are silently skipped. You can force syntastic to check header files by
setting the above variable to 1.
Note~
This checker doesn't call the "makeprgBuild()" function, and thus it ignores
the usual 'g:syntastic_ada_gcc_<option>' variables. The only exception is
'g:syntastic_ada_gcc_exec', which can still be used to override the checker's
executable.
==============================================================================
SYNTAX CHECKERS FOR ANSIBLE *syntastic-checkers-ansible*
The following checkers are available for Ansible (filetype "ansible"):
1. Ansible-lint.............|syntastic-ansible-ansible_lint|
------------------------------------------------------------------------------
1. Ansible-lint *syntastic-ansible-ansible_lint*
Name: ansible_lint
Maintainer: Erik Zaadi <erik.zaadi@gmail.com>
"Ansible-lint" is a style checker for Ansible playbooks. See the project's
page at GitHub for details:
https://github.com/willthames/ansible-lint
Syntastic requires "Ansible-lint" version 2.0.4 or later.
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Note~
You probably also need a plugin to set |filetype| for Ansible playbooks, such
as "ansible-vim":
https://github.com/pearofducks/ansible-vim
==============================================================================
SYNTAX CHECKERS FOR API BLUEPRINT *syntastic-checkers-apiblueprint*
The following checkers are available for API Blueprint (filetype "apiblueprint"):
1. Drafter..................|syntastic-apiblueprint-drafter|
------------------------------------------------------------------------------
1. Drafter *syntastic-apiblueprint-drafter*
Name: drafter
Maintainer: LCD 47 <lcd047@gmail.com>
"Drafter" is a parser for Apiary's "API Blueprint" (http://apiblueprint.org/).
See the project's page at GitHub for details:
https://github.com/apiaryio/drafter
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Note~
You probably also need a plugin to set |filetype| for API Blueprint files, such
as "apiblueprint.vim":
https://github.com/kylef/apiblueprint.vim
==============================================================================
SYNTAX CHECKERS FOR APPLESCRIPT *syntastic-checkers-applescript*
The following checkers are available for AppleScript (filetype "applescript"):
1. osacompile...............|syntastic-applescript-osacompile|
------------------------------------------------------------------------------
1. osacompile *syntastic-applescript-osacompile*
Name: osacompile
Author: Zhao Cai <caizhaoff@gmail.com>
"osacompile" is a compiler for "AppleScript". See the program's manual for
details:
https://developer.apple.com/library/mac/documentation/Darwin/Reference/ManPages/man1/osacompile.1.html
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
==============================================================================
SYNTAX CHECKERS FOR ASCIIDOC *syntastic-checkers-asciidoc*
The following checkers are available for AsciiDoc (filetype "asciidoc"):
1. Asciidoc.................|syntastic-asciidoc-asciidoc|
2. proselint................|syntastic-asciidoc-proselint|
------------------------------------------------------------------------------
1. Asciidoc *syntastic-asciidoc-asciidoc*
Name: asciidoc
Maintainer: LCD 47 <lcd047@gmail.com>
"Asciidoc" is a translator for AsciiDoc documents (http://asciidoc.org/).
Note~
If you would prefer to use Asciidoctor (http://asciidoctor.org/) as an
external checker instead of "Asciidoc", you can do that by pointing
'g:syntastic_asciidoc_asciidoc_exec' to it: >
let g:syntastic_asciidoc_asciidoc_exec = "asciidoctor"
<
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
------------------------------------------------------------------------------
2. proselint *syntastic-asciidoc-proselint*
Name: proselint
Maintainer: LCD 47 <lcd047@gmail.com>
"proselint" is a linter for prose. See the page for details:
http://proselint.com/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
See also: |syntastic-help-proselint|, |syntastic-html-proselint|,
|syntastic-markdown-proselint|, |syntastic-nroff-proselint|,
|syntastic-pod-proselint|, |syntastic-rst-proselint|,
|syntastic-tex-proselint|, |syntastic-texinfo-proselint|,
|syntastic-text-proselint|, |syntastic-xhtml-proselint|.
==============================================================================
SYNTAX CHECKERS FOR ASSEMBLY LANGUAGES *syntastic-checkers-asm*
The following checkers are available for assembly languages (filetype "asm"):
1. GCC......................|syntastic-asm-gcc|
------------------------------------------------------------------------------
1. GCC *syntastic-asm-gcc*
Name: gcc
Maintainer: Joshua Rahm <joshuarahm@gmail.com>
This plugin supports both the AT&T and Intel dialects.
Checker Options~
*'g:syntastic_asm_compiler'*
Type: string
Default: "gcc"
Compiler executable. Set it to something like "mipsel-linux-gcc": >
let g:syntastic_asm_compiler = "mipsel-linux-gcc"
<
*'g:syntastic_asm_errorformat'*
Type: string
Default: unset
Override for the default |'errorformat'|.
*'g:syntastic_asm_dialect'*
Type: string
Default: unset
Normally the assembler will select the dialect to use for checking based on
the file extension (AT&T for ".s", Intel for ".asm"). If you want to override
the automatic choice set this variable to either "att" or "intel".
*'g:syntastic_asm_remove_include_errors'*
Type: boolean
Default: 0
By default, errors in files included from the file being checked are shown.
Set this variable to 1 to remove messages about errors in included files.
Please note that this means syntastic will silently abort checks if there are
fatal errors in one of the included files.
*'g:syntastic_asm_compiler_options'*
Type: string
Default: unset
Compilation flags (such as defines or include directories) to be passed to the
assembler. Set it to something like "-mtune=native": >
let g:syntastic_asm_compiler_options = "-mtune=native"
<
*'g:syntastic_asm_config_file'*
Type: string
Default: ".syntastic_asm_config"
File containing additional compilation flags to be passed to the assembler,
one option per line (see |syntastic-config-files|).
*'g:syntastic_asm_include_dirs'*
Type: array of strings
Default: []
Include directories to be passed to the assembler, in addition to the
above compilation flags. You can set it like this: >
let g:syntastic_asm_include_dirs = ["inc", "asm/src/include"]
<
and the corresponding "-Iinc -Iasm/src/include" will be added to the
compilation flags.
*'b:syntastic_asm_cflags'*
Type: string
Default: unset
Buffer-local variable. Additional compilation flags specific to the current
buffer.
Note~
This checker doesn't call the "makeprgBuild()" function, and thus it ignores
the usual 'g:syntastic_asm_gcc_<option>' variables. The only exception is
'g:syntastic_asm_gcc_exec', which can still be used to override the checker's
executable.
==============================================================================
SYNTAX CHECKERS FOR BEMHTML *syntastic-checkers-bemhtml*
The following checkers are available for BEMHTML (filetype "bemhtml"):
1. bemhtml-lint.............|syntastic-bemhtml-bemhtmllint|
------------------------------------------------------------------------------
1. bemhtml-lint *syntastic-bemhtml-bemhtmllint*
Name: bemhtmllint
Maintainer: Sergej Tatarincev
BEMHTML is a template engine intended for using with the BEM methodology
(http://bem.info/method/). See the project's page at GitHub for details:
https://github.com/SevInf/bemhtml-lint
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
==============================================================================
SYNTAX CHECKERS FOR BRO *syntastic-checkers-bro*
The following checkers are available for Bro (filetype "bro"):
1. Bro......................|syntastic-bro-bro|
------------------------------------------------------------------------------
1. Bro *syntastic-bro-bro*
Name: bro
Maintainer: Justin Azoff <justin.azoff@gmail.com>
"Bro" is a network security monitor. See the project's page for details:
https://www.bro.org/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
==============================================================================
SYNTAX CHECKERS FOR C *syntastic-checkers-c*
The following checkers are available for C (filetype "c"):
1. AVR-GCC..................|syntastic-c-avrgcc|
2. Checkpatch...............|syntastic-c-checkpatch|
3. ClangCheck...............|syntastic-c-clang_check|
4. Clang-Tidy...............|syntastic-c-clang_tidy|
5. Cppcheck.................|syntastic-c-cppcheck|
6. GCC......................|syntastic-c-gcc|
7. make.....................|syntastic-c-make|
8. OClint...................|syntastic-c-oclint|
9. PC-Lint..................|syntastic-c-pc_lint|
10. Sparse..................|syntastic-c-sparse|
11. Splint..................|syntastic-c-splint|
------------------------------------------------------------------------------
1. AVR-GCC *syntastic-c-avrgcc*
Name: avrgcc
Maintainer: Karel <karelishere@gmail.com>
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Additionally:
*'g:syntastic_avrgcc_config_file'*
Type: string
Default: ".syntastic_avrgcc_config"
File containing compilation flags (such as defines or include directories),
one option per line (cf. |syntastic-config-files|).
------------------------------------------------------------------------------
2. Checkpatch *syntastic-c-checkpatch*
Name: checkpatch
Maintainer: Daniel Walker <dwalker@fifo99.com>
"Checkpatch" is a style checker for the Linux kernel sources. It's
distributed along with the Linux kernel sources:
https://github.com/torvalds/linux/blob/master/scripts/checkpatch.pl
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
------------------------------------------------------------------------------
3. ClangCheck *syntastic-c-clang_check*
Name: clang_check
Maintainer: Benjamin Bannier <bbannier@gmail.com>
"ClangCheck" is a wrapper around Clang's "LibTooling"
(http://clang.llvm.org/docs/LibTooling.html). See the official page for
details:
http://clang.llvm.org/docs/ClangCheck.html
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Additionally:
*'g:syntastic_clang_check_config_file'*
Type: string
Default: ".syntastic_clang_check_config"
File containing compilation flags (such as defines or include directories),
one option per line (cf. |syntastic-config-files|).
Note~
By default you can set "ClangCheck" parameters in
'g:syntastic_c_clang_check_args', and compilation parameters
(defines, optimisation flags, etc.) in the configuration file.
However, if you want "ClangCheck" to use compilation databases
(http://clang.llvm.org/docs/JSONCompilationDatabase.html) -- perhaps
generated by "CMake" (https://github.com/rizsotto/Bear) or "Build EAR"
(https://github.com/rizsotto/Bear) -- rather than pass compilation flags
explicitly, set 'g:syntastic_c_clang_check_post_args' to an empty string: >
let g:syntastic_c_clang_check_post_args = ""
<
Configuration files pointed to by 'g:syntastic_clang_check_config_file' are
then ignored.
See also: |syntastic-cpp-clang_check|.
------------------------------------------------------------------------------
4. Clang-Tidy *syntastic-c-clang_tidy*
Name: clang_tidy
Maintainer: Benjamin Bannier <bbannier@gmail.com>
"Clang-Tidy" is a lint tool based on "Clang" (http://clang.llvm.org/). See
the project's page for details:
http://clang.llvm.org/extra/clang-tidy.html
Installation~
"Clang-Tidy" is part of the "Clang" (http://clang.llvm.org/) project, but it
isn't built by default. You need to enable compilation of the "Extra Clang
Tools" (http://clang.llvm.org/docs/ClangTools.html#extra-clang-tools) to get
it. See the build tutorial for details:
http://clang.llvm.org/docs/LibASTMatchersTutorial.html
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Additionally:
*'g:syntastic_clang_tidy_config_file'*
Type: string
Default: ".syntastic_clang_tidy_config"
File containing compilation flags (such as defines or include directories),
one option per line (cf. |syntastic-config-files|).
Note~
By default you can set "ClangTidy" parameters in
'g:syntastic_c_clang_tidy_args', and compilation parameters
(defines, optimisation flags, etc.) in the configuration file.
If you want "ClangTidy" to use compilation databases
(http://clang.llvm.org/docs/JSONCompilationDatabase.html) --
perhaps generated by "CMake" (http://cmake.org/) or "Build EAR"
(https://github.com/rizsotto/Bear) -- rather than pass compilation flags
explicitly, set 'g:syntastic_c_clang_tidy_post_args' to an empty string: >
let g:syntastic_c_clang_tidy_post_args = ""
<
Configuration files pointed to by 'g:syntastic_clang_tidy_config_file' are
then ignored.
See also: |syntastic-cpp-clang_tidy|.
------------------------------------------------------------------------------
5. Cppcheck *syntastic-c-cppcheck*
Name: cppcheck
Maintainer: LCD 47 <lcd047@gmail.com>
"Cppcheck" is a static analysis tool for C/C++ code. See the project's page
for details:
http://cppcheck.sourceforge.net/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Additionally:
*'g:syntastic_cppcheck_config_file'*
Type: string
Default: ".syntastic_cppcheck_config"
File containing compilation flags (such as defines or include directories),
one option per line (cf. |syntastic-config-files|).
See also: |syntastic-cpp-cppcheck|.
------------------------------------------------------------------------------
6. GCC *syntastic-c-gcc*
Name: gcc
Maintainer: Gregor Uhlenheuer <kongo2002@gmail.com>
Checker options~
*'g:syntastic_c_compiler'*
Type: string
Default: "gcc", or "clang" if GCC is not found
Compiler executable.
*'g:syntastic_c_errorformat'*
Type: string
Default: unset
Override for the default |'errorformat'|.
*'g:syntastic_c_remove_include_errors'*
Type: boolean
Default: 0
By default, errors in files included from the file being checked are shown.
Set this variable to 1 to remove messages about errors in included files.
Please note that this means syntastic will silently abort checks if there are
fatal errors in one of the included files.
*'g:syntastic_c_compiler_options'*
Type: string
Default: "-std=gnu99"
Compilation flags (such as defines or include directories) to be passed to the
checker.
*'g:syntastic_c_config_file'*
Type: string
Default: ".syntastic_c_config"
File containing additional compilation flags to be passed to the checker, one
option per line (cf. |syntastic-config-files|).
*'g:syntastic_c_include_dirs'*
Type: array of strings
Default: []
Include directories to be passed to the checker, in addition to the above
compilation flags. You can set it to something like this: >
let g:syntastic_c_include_dirs = ["includes", "headers"]
<
and the corresponding "-Iincludes -Iheaders" will be added to the compilation
flags.
*'g:syntastic_c_no_default_include_dirs'*
Type: boolean
Default: 0
By default syntastic adds a number of common include directories to the
compilation flags, namely: >
-I. -I.. -Iinclude -Iincludes -I../include -I../includes
<
You can disable this behaviour by setting the above variable to 1.
*'g:syntastic_c_no_include_search'*
Type: boolean
Default: 0
By default syntastic looks at the first 100 lines of the file being checked,
and tries to determine if it needs to include headers for some common
libraries, such as "GLib" or "Gtk". It then tries to add the corresponding
include directories to the compilation flags. You can disable this behaviour
by setting the above variable to 1.
*'g:syntastic_c_auto_refresh_includes'*
Type: boolean
Default: 0
Used only if "g:syntastic_c_no_include_search" is set to a false value. By
default syntastic searches for common libraries only the first time the
current file is checked. Setting the above variable to 1 instructs syntastic
to refresh the list of common libraries every time the current file is
checked. You can also force a refresh even when the above variable is 0, by
`:unlet`-ing the buffer variable 'b:syntastic_c_includes'.
*'b:syntastic_c_cflags'*
Type: string
Default: unset
Buffer-local variable. When set, no search for common libraries is performed,
and the contents of the variable are added to the compilation flags.
*'g:syntastic_c_check_header'*
Type: boolean
Default: 0
If the current file is a header (namely if its extension is "h"), all checks
are silently skipped. You can force syntastic to check header files by
setting the above variable to 1.
Note~
This checker doesn't call the "makeprgBuild()" function, and thus it ignores
the usual 'g:syntastic_c_gcc_<option>' variables. The only exception is
'g:syntastic_c_gcc_exec', which can still be used to override the checker's
executable.
See also: |syntastic-cpp-gcc|.
------------------------------------------------------------------------------
7. make *syntastic-c-make*
Name: make
Maintainer: Gregor Uhlenheuer <kongo2002@gmail.com>
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
------------------------------------------------------------------------------
8. OClint *syntastic-c-oclint*
Name: oclint
Maintainer: "UnCO" Lin <undercooled@lavabit.com>
"OClint" is a static code analysis tool. See the project's page for details:
http://oclint.org/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Additionally:
'g:syntastic_oclint_config_file'
Type: string
Default: ".syntastic_oclint_config"
File containing compilation flags (such as defines or include directories),
one option per line (cf. |syntastic-config-files|).
Notes~
By default you can set "OClint" parameters in 'g:syntastic_c_oclint_args', and
compilation parameters (defines, optimisation flags, etc.) in the config file.
If you want "OClint" to use "Clang"-style compilation databases
(http://clang.llvm.org/docs/JSONCompilationDatabase.html) --
perhaps generated by "CMake" (http://cmake.org/) or "Build EAR"
(https://github.com/rizsotto/Bear) -- rather than pass compilation flags
explicitly, set 'g:syntastic_c_oclint_post_args' to an empty string: >
let g:syntastic_c_oclint_post_args = ""
<
Config files pointed to by 'g:syntastic_oclint_config_file' are then ignored.
See also: |syntastic-cpp-oclint|.
------------------------------------------------------------------------------
9. PC-Lint *syntastic-c-pc_lint*
Name: pc_lint
Maintainer: Steve Bragg <steve@empresseffects.com>
"PC-Lint" is a commercial static code analysis tool for Windows, produced
by "Gimpel Software" (http://www.gimpel.com/). See the project's page for
details:
http://www.gimpel.com/html/pcl.htm
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Additionally:
*'g:syntastic_pc_lint_config_file'*
Type: string
Default: "options.lnt"
Name of an indirect (.lnt) file. A file with that name is looked up in the
current directory and in parent directories; first such file found is used.
See also: |syntastic-cpp-pc_lint|.
------------------------------------------------------------------------------
10. Sparse *syntastic-c-sparse*
Name: sparse
Maintainer: Daniel Walker <dwalker@fifo99.com>
"Sparse" is a semantic parser for C, see the official wiki for details:
https://sparse.wiki.kernel.org/index.php/Main_Page
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Additionally:
*'g:syntastic_sparse_config_file'*
Type: string
Default: ".syntastic_sparse_config"
File containing compilation flags (such as defines or include directories),
one option per line (cf. |syntastic-config-files|).
Notes~
If you use "Sparse" with "GCC" you probably want to add something like this to
your vimrc: >
let g:syntastic_c_sparse_post_args="-gcc-base-dir " .
\ system("gcc -v 2>&1 | sed -n '/^Reading specs/ { s#.* /#/#; s#/[^/]*$##; p; }'")
<
This allows "Sparse" to read "GCC"'s private include files.
------------------------------------------------------------------------------
11. Splint *syntastic-c-splint*
Name: splint
Maintainer: LCD 47 <lcd047@gmail.com>
"Splint" is a tool for statically checking C programs for security
vulnerabilities, see the project's page for details:
http://www.splint.org/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Additionally:
*'g:syntastic_splint_config_file'*
Type: string
Default: ".syntastic_splint_config"
File containing project-specific options to be passed to "Splint"
(such as defines or include directories), one option per line (cf.
|syntastic-config-files|).
==============================================================================
SYNTAX CHECKERS FOR C# *syntastic-checkers-cs*
The following checkers are available for C# (filetype "cs"):
1. mcs......................|syntastic-cs-mcs|
------------------------------------------------------------------------------
1. mcs *syntastic-cs-mcs*
Name: mcs
Maintainer: Daniel Walker <dwalker@fifo99.com>
"mcs" is a compiler for C# from the "Mono" project
(http://www.mono-project.com/Main_Page). See the program's manual for details:
http://mono.wikia.com/wiki/Man_mcs
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
==============================================================================
SYNTAX CHECKERS FOR C++ *syntastic-checkers-cpp*
The following checkers are available for C++ (filetype "cpp"):
1. AVR-GCC..................|syntastic-cpp-avrgcc|
2. ClangCheck...............|syntastic-cpp-clang_check|
3. Clang-Tidy...............|syntastic-cpp-clang_tidy|
4. Cppcheck.................|syntastic-cpp-cppcheck|
5. Cpplint..................|syntastic-cpp-cpplint|
6. GCC......................|syntastic-cpp-gcc|
7. OClint...................|syntastic-cpp-oclint|
8. PC-Lint..................|syntastic-cpp-pc_lint|
9. Vera++...................|syntastic-cpp-verapp|
------------------------------------------------------------------------------
1. AVR-GCC *syntastic-cpp-avrgcc*
Name: avrgcc
Maintainer: Sławek Piotrowski <sentinel@atteo.com>
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Additionally:
'g:syntastic_avrgcc_config_file'
Type: string
Default: ".syntastic_avrgcc_config"
File containing compilation flags (such as defines or include directories),
one option per line (cf. |syntastic-config-files|).
See also: |syntastic-c-avrgcc|.
------------------------------------------------------------------------------
2. ClangCheck *syntastic-cpp-clang_check*
Name: clang_check
Maintainer: Benjamin Bannier <bbannier@gmail.com>
"ClangCheck" is a wrapper around Clang's "LibTooling"
(http://clang.llvm.org/docs/LibTooling.html). See the official page for
details:
http://clang.llvm.org/docs/ClangCheck.html
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Additionally:
'g:syntastic_clang_check_config_file'
Type: string
Default: ".syntastic_clang_check_config"
file containing compilation flags (such as defines or include directories),
one option per line (cf. |syntastic-config-files|).
Note~
By default you can set "ClangCheck" parameters in
'g:syntastic_cpp_clang_check_args', and compilation parameters (defines,
optimisation flags, etc.) in the configuration file.
However, if you want "ClangCheck" to use compilation databases
(http://clang.llvm.org/docs/JSONCompilationDatabase.html) -- perhaps
generated by "CMake" (https://github.com/rizsotto/Bear) or "Build EAR"
(https://github.com/rizsotto/Bear) -- rather than pass compilation flags
explicitly, set 'g:syntastic_cpp_clang_check_post_args' to an empty string: >
let g:syntastic_cpp_clang_check_post_args = ""
<
Configuration files pointed to by 'g:syntastic_clang_check_config_file' are
then ignored.
See also: |syntastic-c-clang_check|.
------------------------------------------------------------------------------
3. Clang-Tidy *syntastic-cpp-clang_tidy*
Name: clang_tidy
Maintainer: Benjamin Bannier <bbannier@gmail.com>
"Clang-Tidy" is a lint tool based on "Clang" (http://clang.llvm.org/). See
the project's page for details:
http://clang.llvm.org/extra/clang-tidy.html
Installation~
"Clang-Tidy" is part of the "Clang" (http://clang.llvm.org/) project, but it
isn't built by default. You need to enable compilation of the "Extra Clang
Tools" (http://clang.llvm.org/docs/ClangTools.html#extra-clang-tools) to get
it. See the build tutorial for details:
http://clang.llvm.org/docs/LibASTMatchersTutorial.html
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Additionally:
'g:syntastic_clang_tidy_config_file'
Type: string
Default: ".syntastic_clang_tidy_config"
File containing compilation flags (such as defines or include directories),
one option per line (cf. |syntastic-config-files|).
Note~
By default you can set "ClangTidy" parameters in
'g:syntastic_ppc_clang_tidy_args', and compilation parameters (defines,
optimisation flags, etc.) in the configuration file.
If you want "ClangTidy" to use compilation databases
(http://clang.llvm.org/docs/JSONCompilationDatabase.html) --
perhaps generated by "CMake" (http://cmake.org/) or "Build EAR"
(https://github.com/rizsotto/Bear) -- rather than pass compilation flags
explicitly, set 'g:syntastic_cpp_clang_tidy_post_args' to an empty string: >
let g:syntastic_cpp_clang_tidy_post_args = ""
<
Configuration files pointed to by 'g:syntastic_clang_tidy_config_file' are
then ignored.
See also: |syntastic-c-clang_tidy|.
------------------------------------------------------------------------------
4. Cppcheck *syntastic-cpp-cppcheck*
Name: cppcheck
Maintainer: LCD 47 <lcd047@gmail.com>
"Cppcheck" is a static analysis tool for C/C++ code. See the project's page
for details:
http://cppcheck.sourceforge.net/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Additionally:
'g:syntastic_cppcheck_config_file'
Type: string
Default: ".syntastic_cppcheck_config"
File containing compilation flags (such as defines or include directories),
one option per line (cf. |syntastic-config-files|).
See also: |syntastic-c-cppcheck|.
------------------------------------------------------------------------------
5. Cpplint *syntastic-cpp-cpplint*
Name: cpplint
Maintainer: LCD 47 <lcd047@gmail.com>
For details about "Cpplint" see the project's page:
https://code.google.com/p/google-styleguide/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Additionally:
*'g:syntastic_cpp_cpplint_thres'*
Type: integer
Default: 5
Error threshold. Policy violations with a severity above this value are
highlighted as errors, the others are considered warnings by syntastic.
*'g:syntastic_cpp_cpplint_args'*
Type: string
Default: "--verbose=3"
Command line options to pass to "Cpplint"
Note~
By default syntastic expects the "cpplint" script to be named "cpplint.py".
However, if your "cpplint" was installed with "pip", the script's name is
"cpplint", and you need to set 'g:syntastic_cpp_cpplint_exec' accordingly:
>
let g:syntastic_cpp_cpplint_exec = "cpplint"
<
------------------------------------------------------------------------------
6. GCC *syntastic-cpp-gcc*
Name: gcc
Maintainer: Gregor Uhlenheuer <kongo2002@gmail.com>
Checker options~
*'g:syntastic_cpp_compiler'*
Type: string
Default: "g++", or "clang++" if GCC is not found
Compiler executable.
*'g:syntastic_cpp_errorformat'*
Type: string
Default: unset
Override for the default |'errorformat'|.
*'g:syntastic_cpp_remove_include_errors'*
Type: boolean
Default: 0
By default, errors in files included from the file being checked are shown.
Set this variable to 1 to remove messages about errors in included files.
Please note that this means syntastic will silently abort checks if there are
fatal errors in one of the included files.
*'g:syntastic_cpp_compiler_options'*
Type: string
Default: unset
Compilation flags (such as defines or include directories) to be passed to the
checker.
*'g:syntastic_cpp_config_file'*
Type: string
Default: ".syntastic_cpp_config"
File containing additional compilation flags to be passed to the checker, one
option per line (cf. |syntastic-config-files|).
*'g:syntastic_cpp_include_dirs'*
Type: array of strings
Default: []
Include directories to be passed to the checker, in addition to the above
compilation flags. You can set it to something like this: >
let g:syntastic_cpp_include_dirs = ["includes", "headers"]
>
and the corresponding "-Iincludes -Iheaders" will be added to the compilation
flags.
*'g:syntastic_cpp_no_default_include_dirs'*
Type: boolean
Default: 0
By default syntastic adds a number of common include directories to the
compilation flags, namely: >
-I. -I.. -Iinclude -Iincludes -I../include -I../includes
<
You can disable this behaviour by setting the above variable to 1.
*'g:syntastic_cpp_no_include_search'*
Type: boolean
Default: 0
By default syntastic looks at the first 100 lines of the file being checked,
and tries to determine if it needs to include headers for some common
libraries, such as "GLib" or "Gtk". It then tries to add the corresponding
include directories to the compilation flags. You can disable this behaviour
by setting the above variable to 1.
*'g:syntastic_cpp_auto_refresh_includes'*
Type: boolean
Default: 0
Used only if "g:syntastic_cpp_no_include_search" is set to a false value.
By default syntastic searches for common libraries only the first time the
current file is checked. Setting the above variable to 1 instructs syntastic
to refresh the list of common libraries every time the current file is
checked. You can also force a refresh even when the above variable is 0, by
`:unlet`-ing the buffer variable 'b:syntastic_cpp_includes'.
*'b:syntastic_cpp_cflags'*
Type: string
Default: unset
Buffer-local variable. When set, no search for common libraries is performed,
and the contents of the variable are added to the compilation flags.
*'g:syntastic_cpp_check_header'*
Type: boolean
Default: 0
If the current file is a header (namely if its extension is "h", "hpp", or
"hh"), all checks are silently skipped. You can force syntastic to check
header files by setting the above variable to 1.
Note~
This checker doesn't call the "makeprgBuild()" function, and thus it ignores
the usual 'g:syntastic_cpp_gcc_<option>' variables. The only exception is
'g:syntastic_cpp_gcc_exec', which can still be used to override the checker's
executable.
See also: |syntastic-c-gcc|.
------------------------------------------------------------------------------
7. OClint *syntastic-cpp-oclint*
Name: oclint
Maintainer: "UnCO" Lin <undercooled@lavabit.com>
"OClint" is a static code analysis tool. See the project's page for details:
http://oclint.org/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Additionally:
'g:syntastic_oclint_config_file'
Type: string
Default: ".syntastic_oclint_config"
File containing compilation flags (such as defines or include directories),
one option per line (cf. |syntastic-config-files|).
Notes~
By default you can set "OClint" parameters in 'g:syntastic_cpp_oclint_args',
and compilation parameters (defines, optimisation flags, etc.) in the config
file.
If you want "OClint" to use "Clang"-style compilation databases
(http://clang.llvm.org/docs/JSONCompilationDatabase.html) --
perhaps generated by "CMake" (http://cmake.org/) or "Build EAR"
(https://github.com/rizsotto/Bear) -- rather than pass compilation flags
explicitly, set 'g:syntastic_c_oclint_post_args' to an empty string: >
let g:syntastic_cpp_oclint_post_args = ""
<
Config files pointed to by 'g:syntastic_oclint_config_file' are then ignored.
See also: |syntastic-c-oclint|.
------------------------------------------------------------------------------
8. PC-Lint *syntastic-cpp-pc_lint*
Name: pc_lint
Maintainer: Steve Bragg <steve@empresseffects.com>
"PC-Lint" is a commercial static code analysis tool for Windows, produced
by "Gimpel Software" (http://www.gimpel.com/). See the project's page for
details:
http://www.gimpel.com/html/pcl.htm
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Additionally:
'g:syntastic_pc_lint_config_file'
Type: string
Default: "options.lnt"
Name of an indirect (.lnt) file. A file with that name is looked up in the
current directory and in parent directories; first such file found is used.
See also: |syntastic-c-pc_lint|.
------------------------------------------------------------------------------
9. Vera++ *syntastic-cpp-verapp*
Name: verapp
Maintainer: Lucas Verney <phyks@phyks.me>
"Vera++" is a programmable tool for verification, analysis and transformation
of C++ source code. See the project's page for details:
https://bitbucket.org/verateam/vera/wiki/Home
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Additionally:
*'g:syntastic_verapp_config_file'*
Type: string
Default: ".syntastic_verapp_config"
File containing additional compilation flags to be passed to the checker, one
option per line (cf. |syntastic-config-files|).
==============================================================================
SYNTAX CHECKERS FOR CABAL *syntastic-checkers-cabal*
The following checkers are available for Cabal (filetype "cabal"):
1. Cabal....................|syntastic-cabal-cabal|
------------------------------------------------------------------------------
1. Cabal *syntastic-cabal-cabal*
Name: cabal
Maintainer: Ian D. Bollinger <ian.bollinger@gmail.com>
This checker runs "cabal check" against Haskell Cabal package descriptions.
See the project's page for more information:
http://www.haskell.org/cabal/
Note~
This checker doesn't call the "makeprgBuild()" function, and thus it ignores
the usual 'g:syntastic_cabal_cabal_<option>' variables. The only exception
is 'g:syntastic_cabal_cabal_exec', which can still be used to override the
checker's executable.
==============================================================================
SYNTAX CHECKERS FOR CHEF *syntastic-checkers-chef*
The following checkers are available for Chef (filetype "chef"):
1. Foodcritic...............|syntastic-chef-foodcritic|
------------------------------------------------------------------------------
1. Foodcritic *syntastic-chef-foodcritic*
Name: foodcritic
Maintainer: Doug Ireton
"Foodcritic" is a linter for "Chef" cookbooks (http://www.opscode.com/chef/).
See the project's page for more information:
http://acrmp.github.io/foodcritic/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Note~
You probably also need a plugin to set |filetype| for Chef files, such as
"vim-chef":
https://github.com/dougireton/vim-chef
==============================================================================
SYNTAX CHECKERS FOR COBOL *syntastic-checkers-cobol*
The following checkers are available for COBOL (filetype "cobol"):
1. OpenCOBOL................|syntastic-cobol-cobc|
------------------------------------------------------------------------------
1. OpenCOBOL *syntastic-cobol-cobc*
Name: cobc
Maintainer: LCD 47 <lcd047@gmail.com>
"OpenCOBOL" is a compiler for COBOL. See the project's page for more
information:
http://www.opencobol.org/
Checker options~
*'g:syntastic_cobol_compiler'*
Type: string
Default: "cobc"
Compiler executable.
*'g:syntastic_cobol_errorformat'*
Type: string
Default: unset
Override for the default |'errorformat'|.
*'g:syntastic_cobol_remove_include_errors'*
Type: boolean
Default: 0
By default, errors in files included from the file being checked are shown.
Set this variable to 1 to remove messages about errors in included files.
Please note that this means syntastic will silently abort checks if there are
fatal errors in one of the included files.
*'g:syntastic_cobol_compiler_options'*
Type: string
Default: unset
Compilation flags (such as "-std=cobol2002") to be passed to the checker.
*'g:syntastic_cobol_config_file'*
Type: string
Default: ".syntastic_cobol_config"
File containing additional compilation flags to be passed to the checker, one
option per line (cf. |syntastic-config-files|).
*'g:syntastic_cobol_include_dirs'*
Type: array of strings
Default: []
Include directories to be passed to the checker, in addition to the above
compilation flags. You can set it to something like this: >
let g:syntastic_cobol_include_dirs = ["includes", "headers"]
<
and the corresponding "-Iincludes -Iheaders" will be added to the compilation
flags.
*'b:syntastic_cobol_cflags'*
Type: string
Default: unset
Buffer-local variable. Additional compilation flags specific to the current
buffer.
Note~
This checker doesn't call the "makeprgBuild()" function, and thus it ignores
the usual 'g:syntastic_cobol_cobc_<option>' variables. The only exception
is 'g:syntastic_cobol_cobc_exec', which can still be used to override the
checker's executable.
==============================================================================
SYNTAX CHECKERS FOR COCO *syntastic-checkers-co*
The following checkers are available for Coco (filetype "co"):
1. Coco.....................|syntastic-co-coco|
------------------------------------------------------------------------------
1. Coco *syntastic-co-coco*
Name: coco
Maintainer: Andrew Kelley <superjoe30@gmail.com>
For details about "Coco" see the project's page:
https://github.com/satyr/coco/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
==============================================================================
SYNTAX CHECKERS FOR COFFEESCRIPT *syntastic-checkers-coffee*
The following checkers are available for CoffeeScript (filetype "coffee"):
1. Coffee...................|syntastic-coffee-coffee|
2. CoffeeLint...............|syntastic-coffee-coffeelint|
------------------------------------------------------------------------------
1. Coffee *syntastic-coffee-coffee*
Name: coffee
Maintainer: Lincoln Stoll <l@lds.li>
"Coffee" is a compiler for CoffeeScript. See the project's page for details:
http://coffeescript.org/
Syntastic requires "Coffee" version 1.6.2 or later.
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
------------------------------------------------------------------------------
2. CoffeeLint *syntastic-coffee-coffeelint*
Name: coffeelint
Maintainer: Lincoln Stoll <l@lds.li>
"CoffeeLint" is a style checker for CoffeeScript. See the project's page for
details:
http://www.coffeelint.org/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
==============================================================================
SYNTAX CHECKERS FOR COQ *syntastic-checkers-coq*
The following checkers are available for Coq (filetype "coq"):
1. Coqtop...................|syntastic-coq-coqtop|
------------------------------------------------------------------------------
1. Coqtop *syntastic-coq-coqtop*
Name: coqtop
Maintainer: Matvey Aksenov <matvey.aksenov@gmail.com>
"Coqtop" is the top level interface for Coq. See the project's page for
details:
http://coq.inria.fr/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
==============================================================================
SYNTAX CHECKERS FOR CSS *syntastic-checkers-css*
The following checkers are available for CSS (filetype "css"):
1. CSSLint..................|syntastic-css-csslint|
2. mixedindentlint..........|syntastic-css-mixedindentlint|
3. PHP_CodeSniffer..........|syntastic-css-phpcs|
4. PrettyCSS................|syntastic-css-prettycss|
5. RECESS...................|syntastic-css-recess|
6. stylelint................|syntastic-css-stylelint|
------------------------------------------------------------------------------
1. CSSLint *syntastic-css-csslint*
Name: csslint
Maintainer: Ory Band <oryband@gmail.com>
"CSSLint" is a lint tool for Cascading Stylesheets. See the project's page
for details:
http://csslint.net/
Installation~
Install it with "npm": >
npm install -g csslint
<
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
------------------------------------------------------------------------------
2. mixedindentlint *syntastic-css-mixedindentlint*
Name: mixedindentlint
Maintainer: Payton Swick <payton@foolord.com>
"mixedindentlint" is a general-purpose indentation checker. See the project's
page at GitHub for more information:
https://github.com/sirbrillig/mixedindentlint
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
See also: |syntastic-javascript-mixedindentlint|, |syntastic-scss-mixedindentlint|.
------------------------------------------------------------------------------
3. PHP_CodeSniffer *syntastic-css-phpcs*
Name: phpcs
Maintainer: LCD 47 <lcd047@gmail.com>
"PHP_CodeSniffer" is a style checker for PHP and CSS. See the project's page
at GitHub for details:
https://github.com/squizlabs/PHP_CodeSniffer/
Installation~
Install it with: >
pear install PHP_CodeSniffer
<
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Note~
If you're checking files containing tab characters then "PHP_CodeSniffer"'s
idea of tabstop must match Vim's 'tabstop', otherwise syntastic will highlight
the errors at shifted positions. By default syntastic does that by adding
an option "--tab-width=&tabstop" to "PHP_CodeSniffer", but that option
also instructs "PHP_CodeSniffer" to expand tabs, and some code sniffers
(f.i. "CakePHP", see https://github.com/cakephp/cakephp-codesniffer) insist on
indenting lines with tabs. To work around the resulting mess if you're using
one of these sniffers, set "--tab-width=0" and 'tabstop' to 8: >
let g:syntastic_php_phpcs_args = "--tab-width=0"
set tabstop=8
<
See also: |syntastic-php-phpcs|.
------------------------------------------------------------------------------
4. PrettyCSS *syntastic-css-prettycss*
Name: prettycss
Maintainer: LCD 47 <lcd047@gmail.com>
"PrettyCSS" is a beautifier, lint checker, and validator for Cascading
Stylesheets. For more details see:
PrettyCSS Demo:
http://fidian.github.io/PrettyCSS/
The project's page at GitHub:
https://github.com/fidian/PrettyCSS/
Installation~
Install it with: >
npm install -g PrettyCSS
<
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
------------------------------------------------------------------------------
5. RECESS *syntastic-css-recess*
Name: recess
Maintainer: Tim Carry <tim@pixelastic.com>
"RECESS" is a code quality tool for CSS built on top of LESS. See the
project's page for details:
http://twitter.github.io/recess/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
See also: |syntastic-less-recess|.
------------------------------------------------------------------------------
6. stylelint *syntastic-css-stylelint*
Name: stylelint
Maintainer: Tim Carry <tim@pixelastic.com>
"stylelint" is a style checker for Cascading Stylesheets. See the project's
page for more information:
http://stylelint.io/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
See also: |syntastic-scss-stylelint|.
==============================================================================
SYNTAX CHECKERS FOR CUCUMBER *syntastic-checkers-cucumber*
The following checkers are available for Cucumber (filetype "cucumber"):
1. Cucumber.................|syntastic-cucumber-cucumber|
------------------------------------------------------------------------------
1. Cucumber *syntastic-cucumber-cucumber*
Name: cucumber
Maintainer: Martin Grenfell <martin.grenfell@gmail.com>
"Cucumber" is a tool that executes plain-text functional descriptions as
automated tests. See the project's page for more information:
http://cukes.info/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
==============================================================================
SYNTAX CHECKERS FOR CUDA *syntastic-checkers-cuda*
The following checkers are available for CUDA (filetype "cuda"):
1. NVCC.....................|syntastic-cuda-nvcc|
------------------------------------------------------------------------------
1. NVCC *syntastic-cuda-nvcc*
Name: nvcc
Author: Hannes Schulz <schulz@ais.uni-bonn.de>
"NVCC" is a CUDA Compiler from nVidia. See the project's page for details:
https://developer.nvidia.com/cuda-llvm-compiler
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Additionally:
*'g:syntastic_cuda_check_header'*
Type: boolean
Default: 0
Turn this on to check header files. The checker then creates an empty file
".syntastic_dummy.cu" in the base directory of the file being checked.
Example: >
let g:syntastic_cuda_check_header = 1
<
*'g:syntastic_cuda_config_file'*
Type: string
Default: ".syntastic_cuda_config"
File containing additional compilation flags to be passed to the checker, one
option per line (cf. |syntastic-config-files|).
==============================================================================
SYNTAX CHECKERS FOR D *syntastic-checkers-d*
The following checkers are available for D (filetype "d"):
1. DMD......................|syntastic-d-dmd|
------------------------------------------------------------------------------
1. DMD *syntastic-d-dmd*
Name: dmd
Maintainer: Alfredo Di Napoli <alfredo.dinapoli@gmail.com>
Checker options~
*'g:syntastic_d_compiler'*
Type: string
Default: "dmd"
Compiler executable.
*'g:syntastic_d_errorformat'*
Type: string
Default: unset
Override for the default |'errorformat'|.
*'g:syntastic_d_remove_include_errors'*
Type: boolean
Default: 0
By default, errors in files included from the file being checked are shown.
Set this variable to 1 to remove messages about errors in included files.
Please note that this means syntastic will silently abort checks if there are
fatal errors in one of the included files.
*'g:syntastic_d_compiler_options'*
Type: string
Default: unset
Compilation flags (such as defines or include directories) to be passed to the
checker.
*'g:syntastic_d_config_file'*
Type: string
Default: ".syntastic_d_config"
File containing additional compilation flags to be passed to the checker, one
option per line (cf. |syntastic-config-files|).
*'g:syntastic_d_include_dirs'*
Type: array of strings
Default: inferred from ".dub/packages"
Include directories to be passed to the checker, in addition to the above
compilation flags. You can set it like this: >
let g:syntastic_d_include_dirs = ["includes", "headers"]
<
and the corresponding "-Iincludes -Iheaders" will be added to the compilation
flags.
*'g:syntastic_d_use_dub'*
Type: boolean
Default: 1
Whether to use "dub" to find include directories. This requires "dub" version
0.9.24 or later.
*'g:syntastic_d_dub_exec'*
Type: string
Default: "dub"
Path to the "dub" executable. Ignored if |'g:syntastic_d_use_dub'| is unset.
*'b:syntastic_d_cflags'*
Type: string
Default: unset
Buffer-local variable. Additional compilation flags specific to the current
buffer.
*'g:syntastic_d_check_header'*
Type: boolean
Default: 0
If the current file is a header (namely if its extension is "di"), all checks
are silently skipped. You can force syntastic to check header files by setting
the above variable to 1.
Note~
This checker doesn't call the "makeprgBuild()" function, and thus it ignores
the usual 'g:syntastic_d_dmd_<option>' variables. The only exception is
'g:syntastic_d_dmd_exec', which can still be used to override the checker's
executable.
==============================================================================
SYNTAX CHECKERS FOR DART *syntastic-checkers-dart*
The following checkers are available for Dart (filetype "dart"):
1. Analyzer.................|syntastic-dart-dartanalyzer|
------------------------------------------------------------------------------
1. Analyzer *syntastic-dart-dartanalyzer*
Name: dartanalyzer
Maintainer: Maksim Ryzhikov <rv.maksim@gmail.com>
"Analyzer" is a static analysis tool for Dart (https://www.dartlang.org/).
See the manual for more information:
https://www.dartlang.org/tools/analyzer/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
==============================================================================
SYNTAX CHECKERS FOR DOCBOOK *syntastic-checkers-docbk*
The following checkers are available for DocBook (filetype "docbk"):
1. Igor.....................|syntastic-docbk-igor|
2. xmllint..................|syntastic-docbk-xmllint|
------------------------------------------------------------------------------
1. Igor *syntastic-docbk-igor*
Name: igor
Maintainer: LCD 47 <lcd047@gmail.com>
"Igor" is a proofreader for DocBook SGML, man pages, and text files used by
the FreeBSD project (https://www.freebsd.org/). See the author's presentation
for details:
http://www.youtube.com/watch?v=sczHqUPygZY
The latest version can be obtained from Glen Barber's repository:
http://docscripts.glenbarber.us/tags/igor/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
See also: |syntastic-nroff-igor|, |syntastic-text-igor|.
------------------------------------------------------------------------------
2. xmllint *syntastic-docbk-xmllint*
Name: xmllint
Maintainer: Martin Grenfell <martin.grenfell@gmail.com>
"xmllint" is a checker and transformer tool for XML files, distributed with
the "libxml" package (http://www.xmlsoft.org/). See the tool's manual for more
information:
http://xmlsoft.org/xmllint.html
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Note~
You can use a local installation of DTDs to significantly speed up validation
and allow you to validate XML data without network access. See the
"xmlcatalog" manual, and the catalog documentation for more information:
http://www.xmlsoft.org/xmlcatalog_man.html
http://www.xmlsoft.org/catalog.html
For an example of a DTD catalog see f.i. "XMLCatalog":
https://github.com/darcyparker/XMLCatalog
In order to use it with syntastic you'll have to clone it to a local
directory, and point the environment variable "XML_CATALOG_FILES" to the file
"catalog.xml" in the said directory: >
XML_CATALOG_FILES=/some/path/XMLCatalog/catalog.xml
export XML_CATALOG_FILES
<
Otherwise "xmllint" will try to load XML catalogs from "/etc/xml/catalog".
See also: |syntastic-xml-xmllint|, |syntastic-xslt-xmllint|.
==============================================================================
SYNTAX CHECKERS FOR DOCKERFILE *syntastic-checkers-dockerfile*
The following checkers are available for Dockerfile (filetype "dockerfile"):
1. dockerfile-lint..........|syntastic-dockerfile-dockerfile_lint|
------------------------------------------------------------------------------
1. dockerfile-lint *syntastic-dockerfile-dockerfile_lint*
Name: dockerfile_lint
Maintainer: Tim Carry <tim@pixelastic.com>
"dockerfile-lint" is a linter for Dockerfiles
(http://docs.docker.com/engine/reference/builder). See the project's page at
GitHub for details:
https://github.com/projectatomic/dockerfile_lint
Installation~
Install it with: >
npm install -g dockerfile_lint
<
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
==============================================================================
SYNTAX CHECKERS FOR DUST *syntastic-checkers-dustjs*
The following checkers are available for Dust (filetype "dustjs"):
1. Swiffer..................|syntastic-dustjs-swiffer|
------------------------------------------------------------------------------
1. Swiffer *syntastic-dustjs-swiffer*
Name: swiffer
Maintainer: Steven Foote <smfoote@gmail.com>
"Swiffer" is a command line lint tool for Dust. See the project's page for
details:
https://github.com/smfoote/Swiffer.js
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Note~
To enable Dust syntax checking, you must set the filetype of your Dust
template files to "dustjs". An easy way to do this is by installing the dustjs
syntax highlighter:
https://github.com/jimmyhchan/dustjs.vim
==============================================================================
SYNTAX CHECKERS FOR ELIXIR *syntastic-checkers-elixir*
The following checkers are available for Elixir (filetype "elixir"):
1. elixir...................|syntastic-elixir-elixir|
------------------------------------------------------------------------------
1. elixir *syntastic-elixir-elixir*
Name: elixir
Maintainer: Richard Ramsden <rramsden@gmail.com>
See the project's page for details:
http://elixir-lang.org/
Security~
This checker executes the code in the files it checks:
https://github.com/vim-syntastic/syntastic/issues/1141
This is probably fine if you wrote the files yourself, but it can be a problem
if you're trying to check third party files. If you are 100% willing to let
Vim run the code in your files, set 'g:syntastic_enable_elixir_checker' to 1
in your vimrc to enable this checker: >
let g:syntastic_enable_elixir_checker = 1
<
There is also a buffer-local version of this variable, that takes precedence
over a global one in the buffers where it is defined.
Please note that setting this variable doesn't automatically enable the
checker, you still need to add "elixir" to 'g:syntastic_elixir_checkers' if
you plan to use it.
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
==============================================================================
SYNTAX CHECKERS FOR ERLANG *syntastic-checkers-erlang*
The following checkers are available for Erlang (filetype "erlang"):
1. escript..................|syntastic-erlang-escript|
2. SyntaxErl................|syntastic-erlang-syntaxerl|
------------------------------------------------------------------------------
1. escript *syntastic-erlang-escript*
Name: escript
Maintainer: Pawel Salata <rockplayer.pl@gmail.com>
"escript" is an interpreter for Erlang programs. See the tool's manual for
more information:
http://www.erlang.org/doc/man/escript.html
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Note~
If you get warning: "behaviour X undefined" with your customize behaviour, add
the following line in your vimrc: >
let g:syntastic_erlc_include_path = "ebin"
<
------------------------------------------------------------------------------
2. SyntaxErl *syntastic-erlang-syntaxerl*
Name: syntaxerl
Maintainer: locojay
"SyntaxErl" is a syntax checker for Erlang. It uses "rebar"
(https://github.com/basho/rebar) to determine correct dependencies and library
paths. See the project's page for more information:
https://github.com/ten0s/syntaxerl
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
==============================================================================
SYNTAX CHECKERS FOR ERUBY *syntastic-checkers-eruby*
The following checkers are available for eRuby (filetype "eruby"):
1. Ruby.....................|syntastic-eruby-ruby|
------------------------------------------------------------------------------
1. Ruby *syntastic-eruby-ruby*
Name: ruby
Maintainer: Martin Grenfell <martin.grenfell@gmail.com>
Checker options~
'g:syntastic_ruby_exec'
Type: string
Default: "ruby"
The Ruby executable to use.
Note~
The variable 'g:syntastic_ruby_exec' is also used by the Ruby
"MRI" checker (cf. |syntastic-ruby-mri|), and it can be overriden
by 'g:syntastic_eruby_ruby_exec'. However, this checker doesn't
call the "makeprgBuild()" function, and thus it ignores all other
'g:syntastic_eruby_ruby_<option>' variables.
==============================================================================
SYNTAX CHECKERS FOR FORTRAN *syntastic-checkers-fortran*
The following checkers are available for Fortran (filetype "fortran"):
1. GNU Fortran..............|syntastic-fortran-gfortran|
------------------------------------------------------------------------------
1. GNU Fortran *syntastic-fortran-gfortran*
Name: gfortran
Maintainer: Karl Yngve Lervåg <karl.yngve@lervag.net>
"GNU Fortran" is a checker for Fortran files using either GNU
Fortran (https://gcc.gnu.org/fortran/) or Intel Fortran Compilers
(https://software.intel.com/en-us/fortran-compilers).
Checker options~
*'g:syntastic_fortran_compiler'*
Type: string
Default: "gfortran"
Compiler executable. Set this to either "gfortran" (to use GNU Fortran), or to
"ifort" (for Intel Fortran).
*'g:syntastic_fortran_errorformat'*
Type: string
Default: unset
Override for the default |'errorformat'|.
*'g:syntastic_fortran_remove_include_errors'*
Type: boolean
Default: 0
By default, errors in files included from the file being checked are shown.
Set this variable to 1 to remove messages about errors in included files.
Please note that this means syntastic will silently abort checks if there are
fatal errors in one of the included files.
*'g:syntastic_fortran_compiler_options'*
Type: string
Default: unset
Compilation flags (such as "-std=f95") to be passed to the checker.
*'g:syntastic_fortran_config_file'*
Type: string
Default: ".syntastic_fortran_config"
File containing additional compilation flags to be passed to the checker, one
option per line (cf. |syntastic-config-files|).
*'g:syntastic_fortran_include_dirs'*
Type: array of strings
Default: []
Include directories to be passed to the checker, in addition to the above
compilation flags. You can set it like this: >
let g:syntastic_fortran_include_dirs = ["includes", "headers"]"
<
and the corresponding "-Iincludes -Iheaders" will be added to the compilation
flags.
*'b:syntastic_fortran_cflags'*
Type: string
Default: unset
Buffer-local variable. Additional compilation flags specific to the current
buffer.
Note~
This checker doesn't call the "makeprgBuild()" function, and thus it ignores
the usual 'g:syntastic_fortran_gfortran_<option>' variables. The only
exception is 'g:syntastic_fortran_gfortran_exec', which can still be used to
override the checker's executable.
==============================================================================
SYNTAX CHECKERS FOR GENTOO METADATA *syntastic-checkers-gentoo*
The following checkers are available for Gentoo Metadata (filetype "gentoo"):
1. xmllint..................|syntastic-gentoo-xmllint|
------------------------------------------------------------------------------
1. xmllint *syntastic-gentoo-xmllint*
Name: xmllint
Maintainer: James Rowe <jnrowe@gmail.com>
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Note~
The DTDs required to validate "metadata.xml" files are available in
"$PORTDIR/metadata/dtd", and these local files can be used to significantly
speed up validation. You can create a catalog file with: >
xmlcatalog --create --add rewriteURI http://www.gentoo.org/dtd/ \
${PORTDIR:-/usr/portage}/metadata/dtd/ /etc/xml/gentoo
<
See "xmlcatalog" for more information:
http://www.xmlsoft.org/catalog.html
==============================================================================
SYNTAX CHECKERS FOR GETTEXT PO *syntastic-checkers-po*
The following checkers are available for gettext .po files (filetype "po"):
1. msgfmt...................|syntastic-po-msgfmt|
------------------------------------------------------------------------------
1. msgfmt *syntastic-po-msgfmt*
Name: msgfmt
Maintainer: Ryo Okubo <syucream1031@gmail.com>
"msgfmt" is a compiler for gettext Portable Object
(http://www.gnu.org/software/gettext/manual/html_node/PO-Files.html)
translation files. See the program's manual for details:
http://www.gnu.org/software/gettext/manual/html_node/msgfmt-Invocation.html#msgfmt-Invocation
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
==============================================================================
SYNTAX CHECKERS FOR GLSL *syntastic-checkers-glsl*
The following checkers are available for GLSL (filetype "glsl"):
1. cgc......................|syntastic-glsl-cgc|
------------------------------------------------------------------------------
1. cgc *syntastic-glsl-cgc*
Name: cgc
Maintainer: Joshua Rahm <joshuarahm@gmail.com>
"cgc" is a compiler that translates Cg or GLSL programs into OpenGL or DirectX
code. See the manual for more details:
http://http.developer.nvidia.com/Cg/cgc.html
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Additionally:
*'g:syntastic_glsl_extensions'*
Type: dictionary
Default: unset
You can control the profiles used by "cgc" with magic comments: put the magic
comment "// profile:" followed by the profile for "cgc" to use. For example
use >
// profile: glslf
<
to force the fragment shader profile.
If the magic comment does not exist, then the dictionary
'g:syntastic_glsl_extensions' is used to infer the appropriate profile from
the current file's extension. If this dictionary does not exist either, a
default dictionary is used instead. Finally, if the current file's extension
cannot be found in these dictionaries, the checker assumes a vertex shader
profile.
*'g:syntastic_glsl_options'*
Type: string
Default: unset
Additional arguments to pass to "cgc".
Note~
You probably also need a plugin to set |filetype| for OpenGL files, such as
"vim-glsl":
https://github.com/tikhomirov/vim-glsl
==============================================================================
SYNTAX CHECKERS FOR GO *syntastic-checkers-go*
The following checkers are available for Go (filetype "go"):
1. go.......................|syntastic-go-go|
2. gofmt....................|syntastic-go-gofmt|
3. Golint...................|syntastic-go-golint|
4. Go Meta Linter...........|syntastic-go-gometalinter|
5. gotype...................|syntastic-go-gotype|
6. vet......................|syntastic-go-govet|
------------------------------------------------------------------------------
1. go *syntastic-go-go*
Name: go
Maintainer: Kamil Kisiel <kamil@kamilkisiel.net>
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Additionally:
*'g:syntastic_go_go_build_args'*
Type: string
Default: "-buildmode=archive"
arguments passed to "go build"
*'g:syntastic_go_go_test_args'*
Type: string
Default: "-buildmode=archive"
arguments passed to "go test".
Note~
This syntax checker does not reformat your source code. Use a |BufWritePre|
autocommand towards that end: >
autocmd FileType go autocmd BufWritePre <buffer> Fmt
<
------------------------------------------------------------------------------
2. gofmt *syntastic-go-gofmt*
Name: gofmt
Maintainer: Brandon Thomson <bt@brandonthomson.com>
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Note~
This syntax checker does not reformat your source code. Use a |BufWritePre|
autocommand towards that end: >
autocmd FileType go autocmd BufWritePre <buffer> Fmt
<
------------------------------------------------------------------------------
3. Golint *syntastic-go-golint*
Name: golint
Maintainer: Hiroshi Ioka <hirochachacha@gmail.com>
"Golint" is a linter for Go. See the project's page for details:
https://github.com/golang/lint
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
------------------------------------------------------------------------------
4. Go Meta Linter *syntastic-go-gometalinter*
Name: gometalinter
Maintainer: Joshua Rubin <joshua@rubixconsulting.com>
"Go Meta Linter" is a linter for Go. It runs a number of other linters
against your files, and normalises their output to a standard format.
See the project's page at GitHub for details:
https://github.com/alecthomas/gometalinter
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
------------------------------------------------------------------------------
5. gotype *syntastic-go-gotype*
Name: gotype
Maintainer: luz <ne.tetewi@gmail.com>
See the tool's documentation for details:
https://godoc.org/golang.org/x/tools/cmd/gotype
------------------------------------------------------------------------------
6. vet *syntastic-go-govet*
Name: govet
Maintainer: Kamil Kisiel <kamil@kamilkisiel.net>
See the tool's documentation for details:
https://godoc.org/cmd/vet
Note~
This checker doesn't call the "makeprgBuild()" function, and thus it ignores
the usual 'g:syntastic_go_govet_<option>' variables.
==============================================================================
SYNTAX CHECKERS FOR HAML *syntastic-checkers-haml*
The following checkers are available for Haml (filetype "haml"):
1. Haml.....................|syntastic-haml-haml|
2. HAML-Lint................|syntastic-haml-haml_lint|
------------------------------------------------------------------------------
1. Haml *syntastic-haml-haml*
Name: haml
Maintainer: Martin Grenfell <martin.grenfell@gmail.com>
See the project's page for details:
http://haml.info/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
------------------------------------------------------------------------------
2. HAML-Lint *syntastic-haml-haml_lint*
Name: haml_lint
Maintainer: Shane da Silva <shane@dasilva.io>
"HAML-Lint" is a checker for HAML files. See the project's page for details:
https://github.com/causes/haml-lint
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
==============================================================================
SYNTAX CHECKERS FOR HANDLEBARS *syntastic-checkers-handlebars*
The following checkers are available for Handlebars (filetype "handlebars"):
1. Handlebars...............|syntastic-handlebars-handlebars|
------------------------------------------------------------------------------
1. Handlebars *syntastic-handlebars-handlebars*
Name: handlebars
Maintainer: Jeremy Mack
"Handlebars" is a JavaScript library for building semantic templates. See the
project's page for details:
http://handlebarsjs.com/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Note~
You probably also need a plugin to set |filetype| for Handlebars files, such as
"vim-mustache-handlebars":
https://github.com/mustache/vim-mustache-handlebars
==============================================================================
SYNTAX CHECKERS FOR HASKELL *syntastic-checkers-haskell*
The following checkers are available for Haskell (filetype "haskell"):
1. hdevtools................|syntastic-haskell-hdevtools|
2. HLint....................|syntastic-haskell-hlint|
3. Style scanner............|syntastic-haskell-scan|
------------------------------------------------------------------------------
1. hdevtools *syntastic-haskell-hdevtools*
Name: hdevtools
Maintainer: Anthony Carapetis <anthony.carapetis@gmail.com>
"hdevtools" is a backend for text editor plugins. See the project's page at
GitHub for details:
https://github.com/bitc/hdevtools/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Note~
If you're checking files containing tab characters, then Vim's 'tabstop'
must match "hdevtools"'s idea of tabstop, otherwise column numbers will be
shifted. At the time of this writing, "hdevtools"'s tabstop is hardcoded to 8,
so you should probably add something like this to your vimrc: >
set tabstop=8
<
------------------------------------------------------------------------------
2. HLint *syntastic-haskell-hlint*
Name: hlint
Maintainer: Nicolas Wu <nicolas.wu@gmail.com>
"HLint" is a linter and style checker for Haskell. See the project's page for
details:
http://community.haskell.org/~ndm/hlint/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Note~
If you're checking files containing tab characters, Vim's 'tabstop' must
match "HLint"'s idea of tabstop, otherwise column numbers will be shifted. At
the time of this writing "HLint"'s tabstop is hardcoded to 8, so you should
probably add something like this to your vimrc: >
set tabstop=8
<
------------------------------------------------------------------------------
3. Style scanner *syntastic-haskell-scan*
Name: scan
Maintainer: LCD 47 <lcd047@gmail.com>
"Style scanner" is a style checker for Haskell. See the project's page for
details:
http://projects.haskell.org/style-scanner/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Note~
If you're checking files containing tab characters, Vim's 'tabstop' must
match "Style scanner"'s idea of tabstop, otherwise column numbers will be
shifted. At the time of this writing "Style scanner"'s tabstop is hardcoded to
8, so you should probably add something like this to your vimrc: >
set tabstop=8
<
==============================================================================
SYNTAX CHECKERS FOR HAXE *syntastic-checkers-haxe*
The following checkers are available for Haxe (filetype "haxe"):
1. Haxe.....................|syntastic-haxe-haxe|
------------------------------------------------------------------------------
1. Haxe *syntastic-haxe-haxe*
Name: haxe
Maintainer: David Bernard <david.bernard.31@gmail.com>
"Haxe" is a programming language and compiler that can produce applications
and source code for multiple different platforms from a single code-base. See
the project's page for details:
http://haxe.org/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Additionally:
*'g:vaxe_hxml'*
*'b:vaxe_hxml'*
Type: string
Default: unset
By default the checker will search parent folders for "hxml" files, and
use the first one it finds. You can override that behaviour by pointing
'g:vaxe_hxml' or 'b:vaxe_hxml' to a specific build file. Those variables can
also be set by Vaxe:
https://github.com/jdonaldson/vaxe
==============================================================================
SYNTAX CHECKERS FOR HSS *syntastic-checkers-hss*
The following checkers are available for HSS (filetype "hss"):
1. HSS......................|syntastic-hss-hss|
------------------------------------------------------------------------------
1. HSS *syntastic-hss-hss*
Name: hss
Maintainer: Justin Donaldson <jdonaldson@gmail.com>
"HSS" is a tool that extends the CSS syntax with features such as variables
and nested blocks. See the project's page for details:
http://ncannasse.fr/projects/hss
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
==============================================================================
SYNTAX CHECKERS FOR HTML *syntastic-checkers-html*
The following checkers are available for HTML (filetype "html"):
1. ESLint...................|syntastic-html-eslint|
2. gjslint..................|syntastic-html-gjslint|
3. HTML tidy................|syntastic-html-tidy|
4. HTMLHint.................|syntastic-html-htmlhint|
5. JSHint...................|syntastic-html-jshint|
6. proselint................|syntastic-html-proselint|
7. textlint.................|syntastic-html-textlint|
8. Validator................|syntastic-html-validator|
9. W3.......................|syntastic-html-w3|
------------------------------------------------------------------------------
1. ESLint *syntastic-html-eslint*
Name: eslint
Maintainer: LCD 47 <lcd047@gmail.com>
"ESLint" is a tool for identifying and reporting on patterns found in
ECMAScript/JavaScript code. It can also detect problems in JavaScript code
embedded in HTML files. See the project's page for details:
https://github.com/nzakas/eslint
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Note~
You can also use "eslint_d" (https://github.com/mantoni/eslint_d.js), version
2.1.0 or later, instead of "ESLint". Just point 'g:syntastic_html_eslint_exec'
to it:
https://github.com/mantoni/eslint_d.js#editor-integration
See also: |syntastic-javascript-eslint|, |syntastic-typescript-eslint|.
------------------------------------------------------------------------------
2. gjslint *syntastic-html-gjslint*
Name: gjslint
Maintainer: Martin Grenfell <martin.grenfell@gmail.com>
"Closure Linter", or "gjslint", is a style checker for JavaScript. It can also
detect problems in HTML files. See the project's page for more information:
https://developers.google.com/closure/utilities/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
See also: |syntastic-javascript-gjslint|.
------------------------------------------------------------------------------
3. HTML tidy *syntastic-html-tidy*
Name: tidy
Maintainer: Martin Grenfell <martin.grenfell@gmail.com>
"HTML Tidy" is a syntax checker and formatter for HTML. See the project's page
for more information:
http://www.html-tidy.org/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Additionally:
*'g:syntastic_html_tidy_ignore_errors'*
Type: array of strings
Default: []
List of errors to ignore. Case-sensitive patterns matched as substrings
(not regular expressions) against the error messages. See also
|'syntastic_quiet_messages'|.
*'g:syntastic_html_tidy_blocklevel_tags'*
Type: array of strings
Default: []
List of additional blocklevel tags to be added to "--new-blocklevel-tags".
*'g:syntastic_html_tidy_inline_tags'*
Type: array of strings
Default: []
List of additional inline tags to be added to "--new-inline-tags".
*'g:syntastic_html_tidy_empty_tags'*
Type: array of strings
Default: []
List of additional empty tags, to be added to "--new-empty-tags".
See also: |syntastic-xhtml-tidy|.
------------------------------------------------------------------------------
4. HTMLHint *syntastic-html-htmlhint*
Name: HTMLHint
Maintainer: LCD 47 <lcd047@gmail.com>
"JSHint" is a static code analysis tool for HTML. See the project's page for
details:
http://htmlhint.com/
Syntastic requires "HTMLHint" version 0.9.13 or later.
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
------------------------------------------------------------------------------
5. jshint *syntastic-html-jshint*
Name: JSHint
Maintainer: LCD 47 <lcd047@gmail.com>
"JSHint" can detect JavaScript errors and potential problems in HTML
files. See the project's page for details:
http://jshint.com/
Syntastic requires "JSHint" version 2.4.0 or later.
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Note~
If you're checking files containing tab characters then "JSHint"'s idea of
tabstop must match Vim's 'tabstop', otherwise syntastic will highlight the
errors at shifted positions. By default "JSHint"'s tabstop is 4, while Vim's
default 'tabstop' is 8.
In order to change "JSHint"'s tabstop you have to change its "indent" config
option (cf. http://jshint.com/docs/options/#indent). One way to do that is
to put it in a file named ".jshintrc" in the current directory, the parent
directories, or your home directory. The file is supposed to be in JSON
format. For example: >
{
"indent": 8
}
<
See JSHint documentation for more details:
http://jshint.com/docs/
Please note however that setting "indent" also triggers the indentation checks
in "JSHint". If that is undesirable, your only other option is to leave
"JSHint"'s tabstop alone, and change Vim's 'tabstop' to 4. To change Vim's
'tabstop', you can add this to your vimrc: >
set tabstop=4
<
See also: |syntastic-javascript-jshint|, |syntastic-xhtml-jshint|.
------------------------------------------------------------------------------
6. proselint *syntastic-html-proselint*
Name: proselint
Maintainer: LCD 47 <lcd047@gmail.com>
"proselint" is a linter for prose. See the page for details:
http://proselint.com/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
See also: |syntastic-asciidoc-proselint|, |syntastic-help-proselint|,
|syntastic-markdown-proselint|, |syntastic-nroff-proselint|,
|syntastic-pod-proselint|, |syntastic-rst-proselint|,
|syntastic-tex-proselint|, |syntastic-texinfo-proselint|,
|syntastic-text-proselint|, |syntastic-xhtml-proselint|.
------------------------------------------------------------------------------
7. textlint *syntastic-html-textlint*
Name: textlint
Maintainer: LCD 47 <lcd047@gmail.com>
"textlint" is a natural language linter for text, Markdown, and HTML files.
See the project's page for details:
https://textlint.github.io/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Note~
You need to install both "textlint" and the "textlint HTML" plugin for this to
work:
https://github.com/textlint/textlint-plugin-html
See also: |syntastic-markdown-textlint|, |syntastic-text-textlint|.
------------------------------------------------------------------------------
8. Validator *syntastic-html-validator*
Name: validator
Maintainer: LCD 47 <lcd047@gmail.com>
"Validator" is a non-DTD-based HTML checker. See the project's page for
details:
http://validator.github.io/validator/
As a syntastic checker, you can validate your files against the online service
(see https://validator.nu/), or you can install "vnu.jar":
https://github.com/validator/validator/releases/latest
then run it as a HTTP server: >
$ java -Xss512k -cp /path/to/vnu.jar nu.validator.servlet.Main 8888
<
Requirement~
This checker uses cURL:
http://curl.haxx.se/
Checker options~
*'g:syntastic_html_validator_api'*
Type: string
Default: "http://validator.nu/"
URL of the service to use for checking. Leave it to the default to run the
checks against "https://validator.nu/", or set it to "http://localhost:8888/"
if you have "vnu.jar" installed, and you're running it as a standalone HTTP
server. See:
http://validator.github.io/validator/#standalone
*'g:syntastic_html_validator_parser'*
Type: string
Default: empty
Parser to use. Legal values are: "xml", "xmldtd", "html", "html5", "html4",
and "html4tr". Set it to "html5" to check HTML5 files. References:
https://wiki.whatwg.org/wiki/Validator.nu_Common_Input_Parameters#parser
*'g:syntastic_html_validator_nsfilter'*
Type: string
Default: empty
Sets the "nsfilter" for the parser. See:
https://wiki.whatwg.org/wiki/Validator.nu_Common_Input_Parameters#nsfilter
*'g:syntastic_html_validator_exec'*
Type: string
Default: "curl"
Path to the "cURL" executable. Override it with a full path if your "cURL" is
not installed in a standard location.
This checker doesn't call the "makeprgBuild()" function, and thus it ignores
the usual 'g:syntastic_html_validator_<option>' variables. The only exception
is 'g:syntastic_html_validator_exec', which can be used to override the path
to the "cURL" executable.
Note~
Non-zero exit codes from "cURL" are typically network errors, and are signaled
by syntastic with messages such as: >
syntastic: error: checker html/validator returned abnormal status 26
<
You can lookup the meaning of these codes in cURL's manual:
http://curl.haxx.se/docs/manpage.html#EXIT
------------------------------------------------------------------------------
9. W3 *syntastic-html-w3*
Name: w3
Maintainer: Martin Grenfell <martin.grenfell@gmail.com>
"W3" is the W3C Markup Validator for HTML. See the project's page for
details:
https://validator.w3.org/source/
As a syntastic checker, you can validate your files against the online service
(see http://validator.w3.org/), or you can install it from sources and run it
as a local service:
https://github.com/w3c/markup-validator/
Requirement~
This checker uses cURL:
http://curl.haxx.se/
Checker options~
*'g:syntastic_html_w3_api'*
Type: string
Default: "http://validator.w3.org/check"
URL of the service to use for checking. Leave it to the default to
run the checks against "http://validator.w3.org/", or set it to
"http://localhost/w3c-validator/check" if you're running a local service.
*'g:syntastic_html_w3_exec'*
Type: string
Default: "curl"
Path to the "cURL" executable. Override it with a full path if your "cURL" is
not installed in a standard location.
This checker doesn't call the "makeprgBuild()" function, and thus it ignores
the usual 'g:syntastic_html_w3_<option>' variables. The only exception is
'g:syntastic_html_w3_exec', which can be used to override the path to the
"cURL" executable.
Note~
Non-zero exit codes from "cURL" are typically network errors, and are signaled
by syntastic with messages such as: >
syntastic: error: checker html/validator returned abnormal status 26
<
You can lookup the meaning of these codes in cURL's manual:
http://curl.haxx.se/docs/manpage.html#EXIT
==============================================================================
SYNTAX CHECKERS FOR JAVA *syntastic-checkers-java*
The following checkers are available for Java (filetype "java"):
1. checkstyle...............|syntastic-java-checkstyle|
2. javac....................|syntastic-java-javac|
------------------------------------------------------------------------------
1. checkstyle *syntastic-java-checkstyle*
Name: checkstyle
Maintainer: Dmitry Geurkov <d.geurkov@gmail.com>
"Checkstyle" is a style checker for Java. See the project's page for details:
http://checkstyle.sourceforge.net/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Additionally:
*'g:syntastic_java_checkstyle_classpath'*
Type: string
Default: "checkstyle-6.10.1-all.jar"
Classpath to use. Multiple files are allowed.
*'g:syntastic_java_checkstyle_conf_file'*
Type: string
Default: "sun_checks.xml"
Path to the configuration file for the "-c" option (cf.
http://checkstyle.sourceforge.net/cmdline.html#Command_line_usage).
Notes~
1. The checker was tested with "checkstyle" version 5.5. If you're using
it with version 5.6 or later you should remove DoubleCheckedLocking from
your configuration file:
http://stackoverflow.com/a/12798807/1658042
2. At the time of this writing, the "checkstyle" checker doesn't distinguish
between error severity levels. All messages are treated as errors, regardless
of their severity defined in the "checkstyle" config file.
3. You can specify a property file: >
let g:syntastic_java_checkstyle_post_args =
\ ["-p", "/path/to/checkstyle.properties"]
<
4. You probably want to download the "fat jar" "checkstyle-*-all.jar" and
point |'g:syntastic_java_checkstyle_classpath'| to it:
http://iweb.dl.sourceforge.net/project/checkstyle/checkstyle/
http://checkstyle.sourceforge.net/cmdline.html#Usage_by_Classpath_update
Current builds at Maven Central do not package "checkstyle" with its
dependencies:
http://search.maven.org/#search|gav|1|g%3A%22com.puppycrawl.tools%22%20AND%20a%3A%22checkstyle%22
However, |'g:syntastic_java_checkstyle_classpath'| accepts multiple files if
you want to include the "checkstyle" jar and all of its dependencies.
------------------------------------------------------------------------------
2. javac *syntastic-java-javac*
Name: javac
Maintainers: Jochen Keil <jochen.keil@gmail.com>
Dmitry Geurkov <d.geurkov@gmail.com>
Note~
This checker is not suitable for use with large Java projects. The design
of "javac" makes this checker prone to running into various limitations of
your shell, Vim, and your Java compiler. You are strongly advised to use
something like Eclim (http://eclim.org/) instead of syntastic for projects of
any substantial size or complexity.
Commands~
The following commands are available:
*:SyntasticJavacEditClasspath*
This opens a new window where you can specify a classpath. Individual paths
may be specified one per line, or separated by colons ":" on UNIX, or by
semicolons ";" on Windows.
*:SyntasticJavacEditConfig*
This command relevant only if |'g:syntastic_java_javac_config_file_enabled'|
is set. It opens a buffer where you can specify project-specific options from
the list below. These options will be saved in a file pointed to by
|'g:syntastic_java_javac_config_file'| (".syntastic_javac_config" by default).
Set |'g:syntastic_java_javac_config_file'| to a full path to use a
project-wide configuration file, rather than a file in the current directory.
The settings have to be specified as Vim commands.
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Additionally:
*'g:syntastic_java_javac_executable'*
Type: string
Default: "javac"
Compiler executable used for checking files.
*'g:syntastic_java_maven_executable'*
Type: string
Default: "mvn"
Maven executable used for loading classpath for "maven" projects.
*'g:syntastic_java_javac_options'*
Type: string
Default: "-Xlint"
Options for "javac".
*'g:syntastic_java_javac_classpath'*
Type: string
Default: ""
Classpath. It can be changed by running the `:SyntasticJavacEditClasspath`
command.
*'g:syntastic_java_javac_delete_output'*
Type: boolean
Default: 1
When set the checker will delete the ".class" files created by "javac".
*'g:syntastic_java_javac_autoload_maven_classpath'*
Type: boolean
Default: 1
If enabled and a file "pom.xml" is found in the current working directory,
"maven" is used to load classpath.
*'g:syntastic_java_javac_config_file'*
Type: string
Default: ".syntastic_javac_config"
Path to the configuration file used by "javac". As usual, if a filename is
specified rather than a full path, the file is created and looked for in the
current directory.
*'g:syntastic_java_javac_config_file_enabled'*
Type: boolean
Default: 0
When enabled, the classpath is written to the file pointed to by
|'g:syntastic_java_javac_config_file'|. The file is created as needed.
You can edit this file with the `:SyntasticJavacEditClasspath` command.
The change will take effect next time you run the checker.
*'g:syntastic_java_javac_custom_classpath_command'*
Type: string
Default: ""
Custom command to run in order to get the classpath. The command classpath
output can be in traditional Java form, or specified on separate lines.
"%file_path%", "%FILE_NAME%", and "%FILE_DIR%" are expanded to the current
file's full path, filename, and base directory respectively, all of them
escaped for use in a shell command.
Using Ant~
When using "ant" (http://ant.apache.org/) you can have a custom build target
(named for example "path") that will output your project's classpath. You can
then use `:SyntasticJavacEditConfig` and add the following line to use it with
"javac" checker: >
let g:syntastic_java_javac_custom_classpath_command =
\ "ant -q path | grep echo | cut -f2- -d] | tr -d ' ' | tr ':' '\n'"
<
Using Gradle~
For "Gradle" projects (http://gradle.org/) you might consider using
"gradle-syntastic-plugin":
https://github.com/Scuilion/gradle-syntastic-plugin
This will write the relevant classpath to a file ".syntastic_javac_config".
==============================================================================
SYNTAX CHECKERS FOR JAVASCRIPT *syntastic-checkers-javascript*
The following checkers are available for JavaScript (filetype "javascript"):
1. Closure Compiler.........|syntastic-javascript-closurecompiler|
2. ESLint...................|syntastic-javascript-eslint|
3. Flow.....................|syntastic-javascript-flow|
4. gjslint..................|syntastic-javascript-gjslint|
5. JavaScript Lint..........|syntastic-javascript-jsl|
6. JSCS.....................|syntastic-javascript-jscs|
7. JSHint...................|syntastic-javascript-jshint|
8. JSLint...................|syntastic-javascript-jslint|
9. JSXHint..................|syntastic-javascript-jsxhint|
10. mixedindentlint.........|syntastic-javascript-mixedindentlint|
11. standard................|syntastic-javascript-standard|
12. tern-lint...............|syntastic-javascript-tern_lint|
------------------------------------------------------------------------------
1. Closure Compiler *syntastic-javascript-closurecompiler*
Name: closurecompiler
Maintainer: Motohiro Takayama <mootoh@gmail.com>
"Closure Compiler" is a compiler for JavaScript maintained by Google. See the
project's page for details:
https://developers.google.com/closure/compiler/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Additionally:
*'g:syntastic_javascript_closurecompiler_path'*
Type: string
Default: unset
Path to "google-closure-compiler.jar"
*'g:syntastic_javascript_closurecompiler_script'*
Type: string
Default: unset
Path to a "closurecompiler" executable script.
Note~
In order to enable the checker you have to set exactly one of the options
above. If you have a package manager (such as "Homebrew") that installs a
shell script that runs "Closure Compiler", point
|'g:syntastic_javascript_closurecompiler_script'| to that script. Otherwise
set |'g:syntastic_javascript_closurecompiler_path'| to point to the "Closure
Compiler" jar file.
------------------------------------------------------------------------------
2. ESLint *syntastic-javascript-eslint*
Name: eslint
Maintainer: Maksim Ryzhikov <rv.maksim@gmail.com>
"ESLint" is a tool for identifying and reporting on patterns found in
ECMAScript/JavaScript code. See the project's page for details:
https://github.com/nzakas/eslint
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Note~
You can also use "eslint_d" (https://github.com/mantoni/eslint_d.js),
version 2.1.0 or later, instead of "ESLint". Just point
'g:syntastic_javascript_eslint_exec' to it:
https://github.com/mantoni/eslint_d.js#editor-integration
See also: |syntastic-html-eslint|, |syntastic-typescript-eslint|.
------------------------------------------------------------------------------
3. Flow *syntastic-javascript-flow*
Name: flow
Maintainer: Michael Robinson <mike@pagesofinterest.net>
"Flow" is a static type checker for JavaScript, written by Facebook. See the
project's page for details:
http://flowtype.org/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Notes~
Syntastic requires "Flow" version 0.18.1 or later.
To use "Flow" with your projects, you must:
a. Install it:
https://github.com/flowtype/flow-bin
b. Configure your project:
>
cd /path/to/your/project
flow init
<
c. Read the docs to find out more. It won't work out of the box.
http://flowtype.org/docs/existing.html
------------------------------------------------------------------------------
4. gjslint *syntastic-javascript-gjslint*
Name: gjslint
Maintainer: Martin Grenfell <martin.grenfell@gmail.com>
"Closure Linter", or "gjslint", is a style checker for JavaScript. See the
project's page for more information:
https://developers.google.com/closure/utilities/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
See also: |syntastic-html-gjslint|.
------------------------------------------------------------------------------
5. JavaScript Lint *syntastic-javascript-jsl*
Name: jsl
Maintainer: Martin Grenfell <martin.grenfell@gmail.com>
For details about "JavaScript Lint" see the project's page:
http://www.javascriptlint.com/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
------------------------------------------------------------------------------
6. JSCS *syntastic-javascript-jscs*
Name: jscs
Maintainer: LCD 47 <lcd047@gmail.com>
"JSCS" is a code style checker for JavaScript. See the project's page for
more information:
https://github.com/mdevils/node-jscs
Syntastic requires "JSCS" version 0.2.0 or later.
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
------------------------------------------------------------------------------
7. JSHint *syntastic-javascript-jshint*
Name: jshint
Maintainer: Martin Grenfell <martin.grenfell@gmail.com>
"JSHint" is a tool to detect errors and potential problems in JavaScript
files. See the project's page for details:
http://jshint.com/
Syntastic requires "JSHint" version 1.0.0 or later.
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Notes~
If you're checking files containing tab characters then "JSHint"'s idea of
tabstop must match Vim's 'tabstop', otherwise syntastic will highlight the
errors at shifted positions. By default "JSHint"'s tabstop is 4, while Vim's
default 'tabstop' is 8.
In order to change "JSHint"'s tabstop you have to change its "indent" config
option (cf. http://jshint.com/docs/options/#indent). One way to do that is
to put it in a file named ".jshintrc" in the current directory, the parent
directories, or your home directory. The file is supposed to be in JSON
format. For example: >
{
"indent": 8
}
<
See JSHint documentation for more details:
http://jshint.com/docs/
Please note however that setting "indent" also triggers the indentation checks
in "JSHint". If that is undesirable, your only other option is to leave
"JSHint"'s tabstop alone, and change Vim's 'tabstop' to 4. To change Vim's
'tabstop', you can add this to your vimrc: >
set tabstop=4
<
See also: |syntastic-html-jshint|, |syntastic-xhtml-jshint|.
------------------------------------------------------------------------------
8. JSLint *syntastic-javascript-jslint*
Name: jslint
Maintainer: Martin Grenfell <martin.grenfell@gmail.com>
"JSLint" is a code quality checker for JavaScript. See the program's page for
details:
http://www.jslint.com/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Note~
By default the checker calls "JSLint" with these options: >
--white --nomen --regexp --plusplus --bitwise --newcap --sloppy --vars
<
This can be changed by setting 'g:syntastic_javascript_jslint_args' in your
vimrc to your own list of options, for example: >
let g:syntastic_javascript_jslint_args =
\ "--nomen --regexp --browser --devel --windows --sloppy --vars"
<
Setting this variable to the empty string "" is allowed, and instructs
syntastic to call "JSLint" with no options.
------------------------------------------------------------------------------
9. JSXHint *syntastic-javascript-jsxhint*
Name: JSXHint
Maintainer: Thomas Boyt <me@thomasboyt.com>
"JSXHint" is a wrapper around JSHint (http://jshint.com/) for
linting JSX syntax, which is inline markup-in-JS used by React
(http://facebook.github.io/react/docs/getting-started.html).
See the project's page for details:
https://github.com/strml/jsxhint
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Installation~
Install it with "npm": >
npm install -g jsxhint
<
Syntastic requires "JSXHint" version v0.4.1 or later. You also need "JSHint"
v1.1.0 or later.
Note~
Since "JSXHint" is a wrapper around JSHint, the following note relevant to
the latter still applies:
If you're checking files containing tab characters then JSHint's idea of
tabstop must match Vim's 'tabstop', otherwise syntastic will highlight the
errors at shifted positions. By default JSHint's tabstop is 4, while Vim's
default 'tabstop' is 8.
In order to change "JSHint"'s tabstop you have to change its "indent" config
option (http://jshint.com/docs/options/#indent). One way to do that is to
put it in a file named ".jshintrc" in the current directory, the parent
directories, or your home directory. The file is supposed to be in JSON
format. For example: >
{
"indent": 8
}
<
See JSHint documentation for more details:
http://jshint.com/docs/
Please note however that setting "indent" also triggers the indentation checks
in JSHint. If that is undesirable, your only other option is to leave JSHint's
tabstop alone, and change Vim's 'tabstop' to 4. To change Vim's 'tabstop', you
can add this to your 'vimrc': >
set tabstop=4
<
Alternative~
"JSXHint" will not show JSX-related errors in syntastic, because failed JSX
compiles will result in the uncompiled data being passed to JSHint:
https://github.com/STRML/JSXHint/issues/45
To get around this, "Syntastic-React" can be used as a replacement for
"JSXHint":
https://github.com/jaxbot/syntastic-react
------------------------------------------------------------------------------
10. mixedindentlint *syntastic-javascript-mixedindentlint*
Name: mixedindentlint
Maintainer: Payton Swick <payton@foolord.com>
"mixedindentlint" is a general-purpose indentation checker. See the project's
page at GitHub for more information:
https://github.com/sirbrillig/mixedindentlint
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
See also: |syntastic-css-mixedindentlint|, |syntastic-scss-mixedindentlint|.
------------------------------------------------------------------------------
11. standard *syntastic-javascript-standard*
Name: standard
Maintainer: LCD 47 <lcd047@gmail.com>
"Standard" is a code style checker for JavaScript. See the project's page for
more information:
https://github.com/feross/standard
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Additionally:
*'g:syntastic_javascript_standard_generic'*
Type: boolean
Default: 0
Flag that can be used to disable version checks for "standard".
Note~
Most forks of "standard" can also be used with syntastic. Just
set 'g:syntastic_javascript_standard_generic' to 1, and point
'g:syntastic_javascript_standard_exec' to the fork's executable. For
example to use happiness (https://github.com/JedWatson/happiness) instead of
"standard": >
let g:syntastic_javascript_checkers = ["standard"]
let g:syntastic_javascript_standard_exec = "happiness"
let g:syntastic_javascript_standard_generic = 1
<
------------------------------------------------------------------------------
12. tern-lint *syntastic-javascript-tern_lint*
Name: tern_lint
Maintainer: LCD 47 <lcd047@gmail.com>
"tern-lint" is a static type checker for JavaScript. See the project's page
for more information:
https://github.com/angelozerr/tern-lint
Syntastic requires a version of Vim compiled with the |+byte_offset| feature
to use this checker.
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Note~
"tern-lint" recursively scans files starting from (Vim's idea of) the current
directory, regardless of the current file.
==============================================================================
SYNTAX CHECKERS FOR JSON *syntastic-checkers-json*
The following checkers are available for JSON (filetype "json"):
1. JSONLint.................|syntastic-json-jsonlint|
2. jsonval..................|syntastic-json-jsonval|
------------------------------------------------------------------------------
1. JSONLint *syntastic-json-jsonlint*
Name: jsonlint
Maintainer: Miller Medeiros <contact@millermedeiros.com>
"JSONLint" is a validator for JSON. See the project's page for details:
http://jsonlint.com/
Installation~
Install it with: >
npm install -g jsonlint
<
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
------------------------------------------------------------------------------
2. jsonval *syntastic-json-jsonval*
Name: jsonval
Maintainer: Miller Medeiros <contact@millermedeiros.com>
"jsonval" is a validator for JSON. See the project's page at GitHub for
details:
https://github.com/dangerousben/jsonval
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
==============================================================================
SYNTAX CHECKERS FOR LESS *syntastic-checkers-less*
The following checkers are available for LESS (filetype "less"):
1. lessc....................|syntastic-less-lessc|
2. RECESS...................|syntastic-less-recess|
------------------------------------------------------------------------------
1. lessc *syntastic-less-lessc*
Name: lessc
Maintainer: Julien Blanchard <julien@sideburns.eu>
"lessc" is a compiler for LESS. See the project's page for details:
http://lesscss.org/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Additionally:
*'g:syntastic_less_use_less_lint'*
Type: boolean
Default: 0
Flag that can be set to instruct syntastic to run "less-lint" instead of
"less".
------------------------------------------------------------------------------
2. RECESS *syntastic-less-recess*
Name: recess
Maintainer: Tim Carry <tim@pixelastic.com>
"RECESS" is a code quality tool for CSS built on top of LESS. See the
project's page for details:
http://twitter.github.io/recess/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
See also: |syntastic-css-recess|.
==============================================================================
SYNTAX CHECKERS FOR LEX *syntastic-checkers-lex*
The following checkers are available for Lex (filetype "lex"):
1. flex.....................|syntastic-lex-flex|
------------------------------------------------------------------------------
1. flex *syntastic-lex-flex*
Name: flex
Maintainer: LCD 47 <lcd047@gmail.com>
"Flex" is the GNU implementation of the standard UNIX lexical analyzer "lex"
(http://en.wikipedia.org/wiki/Lex_programming_tool). See the project's page
for more information:
http://flex.sourceforge.net/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
==============================================================================
SYNTAX CHECKERS FOR LIMBO *syntastic-checkers-limbo*
The following checkers are available for Limbo (filetype "limbo"):
1. Limbo....................|syntastic-limbo-limbo|
------------------------------------------------------------------------------
1. Limbo *syntastic-limbo-limbo*
Name: limbo
Maintainer: Alex Efros <powerman-asdf@ya.ru>
"Limbo" is a compiler for the Limbo language
(http://doc.cat-v.org/inferno/4th_edition/limbo_language/), the
language used to write applications for the "Inferno" operating system
(http://doc.cat-v.org/inferno/). See the "Inferno" project's page for
a reference implementation:
http://code.google.com/p/inferno-os/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
==============================================================================
SYNTAX CHECKERS FOR LISP *syntastic-checkers-lisp*
The following checkers are available for LISP (filetype "lisp"):
1. CLISP....................|syntastic-lisp-clisp|
------------------------------------------------------------------------------
1. CLISP *syntastic-lisp-clisp*
Name: clisp
Maintainer: Karl Yngve Lervåg <karl.yngve@lervag.net>
"CLISP" is an interpreter for LISP programs. See the project's page for
details:
http://www.clisp.org/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
==============================================================================
SYNTAX CHECKERS FOR LLVM *syntastic-checkers-llvm*
The following checkers are available for LLVM (filetype "llvm"):
1. LLVM.....................|syntastic-llvm-llvm|
------------------------------------------------------------------------------
1. LLVM *syntastic-llvm-llvm*
Name: llvm
Maintainer: Andrew Kelley <superjoe30@gmail.com>
"LLVM" is the intermediate language for the LLVM compilers (http://llvm.org/).
See the reference manual for details:
http://llvm.org/docs/LangRef.html
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
==============================================================================
SYNTAX CHECKERS FOR LUA *syntastic-checkers-lua*
The following checkers are available for Lua (filetype "lua"):
1. luac.....................|syntastic-lua-luac|
2. luacheck.................|syntastic-lua-luacheck|
------------------------------------------------------------------------------
1. luac *syntastic-lua-luac*
Name: luac
Maintainer: Gregor Uhlenheuer <kongo2002@gmail.com>
"luac" is a compiler for Lua. See the tool's manual for details:
http://www.lua.org/manual/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Note~
"luac" truncates filenames when the full path of the files involved is longer
than a certain fixed amount. Syntastic can't detect this situation, and will
silently ignore error messages with truncated filenames.
------------------------------------------------------------------------------
2. luacheck *syntastic-lua-luacheck*
Name: luacheck
Maintainer: Thiago Bastos <tbastos@tbastos.com>
"Luacheck" is a tool for static analysis of Lua code. See the project's page
for details:
https://github.com/mpeterv/luacheck
In contrast to "luac" (see |syntastic-lua-luac|) which only flags syntax
errors, this checker detects code smells, so you probably want to enable both
when available.
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Note~
A sensible set of options for LUA projects might be something like this: >
let g:syntastic_check_on_open = 1
let g:syntastic_lua_checkers = ["luac", "luacheck"]
let g:syntastic_lua_luacheck_args = "--no-unused-args"
<
==============================================================================
SYNTAX CHECKERS FOR MARKDOWN *syntastic-checkers-markdown*
The following checkers are available for Markdown (filetype "markdown"):
1. Markdown lint tool.......|syntastic-markdown-mdl|
2. proselint................|syntastic-markdown-proselint|
3. textlint.................|syntastic-markdown-textlint|
------------------------------------------------------------------------------
1. Markdown lint tool *syntastic-markdown-mdl*
Name: mdl
Maintainer: Charles Beynon <etothepiipower@gmail.com>
"Markdown lint tool" is a style checker for Markdown files. See the project's
page at GitHub for details:
https://github.com/mivok/markdownlint
Installation~
Install it with: >
gem install mdl
<
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Note~
You can also use the "Node.js"-based "markdownlint-cli" as a checker instead
of "mdl":
https://github.com/igorshubovych/markdownlint-cli
To do that, you have to point 'g:syntastic_markdown_mdl_exec' to
"markdownlint", and set 'g:syntastic_markdown_mdl_args' to an empty string (or
to a set of valid "markdownlint-cli" options): >
let g:syntastic_markdown_mdl_exec = "markdownlint"
let g:syntastic_markdown_mdl_args = ""
<
------------------------------------------------------------------------------
2. proselint *syntastic-markdown-proselint*
Name: proselint
Maintainer: LCD 47 <lcd047@gmail.com>
"proselint" is a linter for prose. See the page for details:
http://proselint.com/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
See also: |syntastic-asciidoc-proselint|, |syntastic-help-proselint|,
|syntastic-html-proselint|, |syntastic-nroff-proselint|,
|syntastic-pod-proselint|, |syntastic-rst-proselint|,
|syntastic-tex-proselint|, |syntastic-texinfo-proselint|,
|syntastic-text-proselint|, |syntastic-xhtml-proselint|.
------------------------------------------------------------------------------
3. textlint *syntastic-markdown-textlint*
Name: textlint
Maintainer: LCD 47 <lcd047@gmail.com>
"textlint" is a natural language linter for text, Markdown, and HTML files.
See the project's page for details:
https://textlint.github.io/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
See also: |syntastic-html-textlint|, |syntastic-text-textlint|.
==============================================================================
SYNTAX CHECKERS FOR MATLAB *syntastic-checkers-matlab*
The following checkers are available for MATLAB (filetype "matlab"):
1. mlint....................|syntastic-matlab-mlint|
------------------------------------------------------------------------------
1. mlint *syntastic-matlab-mlint*
Name: mlint
Maintainer: Jason Graham <jason@the-graham.com>
"mlint" is a code checker for MATLAB. The "mlint" binary is distributed with
the "MATLAB" package:
http://www.mathworks.com/help/matlab/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
==============================================================================
SYNTAX CHECKERS FOR MERCURY *syntastic-checkers-mercury*
The following checkers are available for Mercury (filetype "mercury"):
1. mmc......................|syntastic-mercury-mmc|
------------------------------------------------------------------------------
1. mmc *syntastic-mercury-mmc*
Name: mmc
Maintainer: Joshua Rahm <joshuarahm@gmail.com>
"mmc" is a compiler for Mercury. See Mercury's page for more details:
http://www.mercurylang.org/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
==============================================================================
SYNTAX CHECKERS FOR NASM *syntastic-checkers-nasm*
The following checkers are available for NASM (filetype "nasm"):
1. nasm.....................|syntastic-nasm-nasm|
------------------------------------------------------------------------------
1. nasm *syntastic-nasm-nasm*
Name: nasm
Maintainer: HĂĽvard Pettersson <haavard.pettersson@gmail.com>
"NASM" is an assembler and disassembler for the Intel x86 architecture. See
the project's page for details:
http://www.nasm.us/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
==============================================================================
SYNTAX CHECKERS FOR NIX *syntastic-checkers-nix*
The following checkers are available for Nix (filetype "nix"):
1. Nix......................|syntastic-nix-nix|
------------------------------------------------------------------------------
1. Nix *syntastic-nix-nix*
Name: nix
Maintainer: Tim Cuthbertson <tim@gfxmonk.net>
"Nix" is a checker for language "Nix" using "nix-instantiate". See the
project's page for details:
http://nixos.org/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
==============================================================================
SYNTAX CHECKERS FOR NROFF *syntastic-checkers-nroff*
The following checkers are available for nroff (filetype "nroff"):
1. Igor.....................|syntastic-nroff-igor|
2. mandoc...................|syntastic-nroff-mandoc|
3. proselint................|syntastic-nroff-proselint|
------------------------------------------------------------------------------
1. Igor *syntastic-nroff-igor*
Name: igor
Maintainer: LCD 47 <lcd047@gmail.com>
"Igor" is a proofreader for DocBook SGML, man pages, and text files used by
the FreeBSD project (https://www.freebsd.org/). See the author's presentation
for details:
http://www.youtube.com/watch?v=sczHqUPygZY
The latest version can be obtained from Glen Barber's repository:
http://docscripts.glenbarber.us/tags/igor/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
See also: |syntastic-docbk-igor|, |syntastic-text-igor|.
------------------------------------------------------------------------------
2. mandoc *syntastic-nroff-mandoc*
Name: mandoc
Maintainer: LCD 47 <lcd047@gmail.com>
See the project's page for details:
http://mdocml.bsd.lv/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
------------------------------------------------------------------------------
3. proselint *syntastic-nroff-proselint*
Name: proselint
Maintainer: LCD 47 <lcd047@gmail.com>
"proselint" is a linter for prose. See the page for details:
http://proselint.com/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
See also: |syntastic-asciidoc-proselint|, |syntastic-help-proselint|,
|syntastic-html-proselint|, |syntastic-markdown-proselint|,
|syntastic-pod-proselint|, |syntastic-rst-proselint|,
|syntastic-tex-proselint|, |syntastic-texinfo-proselint|,
|syntastic-text-proselint|, |syntastic-xhtml-proselint|.
==============================================================================
SYNTAX CHECKERS FOR OBJECTIVE-C *syntastic-checkers-objc*
The following checkers are available for Objective-C (filetype "objc"):
1. GCC......................|syntastic-objc-gcc|
2. OClint...................|syntastic-objc-oclint|
------------------------------------------------------------------------------
1. GCC *syntastic-objc-gcc*
Name: gcc
Maintainer: Gregor Uhlenheuer <kongo2002@gmail.com>
Checker options~
*'g:syntastic_objc_compiler'*
Type: string
Default: "gcc", or "clang" if GCC is not found
Compiler executable.
*'g:syntastic_objc_errorformat'*
Type: string
Default: unset
Override for the default |'errorformat'|.
*'g:syntastic_objc_remove_include_errors'*
Type: boolean
Default: 0
By default, errors in files included from the file being checked are shown.
Set this variable to 1 to remove messages about errors in included files.
Please note that this means syntastic will silently abort checks if there are
fatal errors in one of the included files.
*'g:syntastic_objc_compiler_options'*
Type: string
Default: unset
Compilation flags (such as defines or include directories) to be passed to the
checker.
*'g:syntastic_objc_config_file'*
Type: string
Default: ".syntastic_objc_config"
File containing additional compilation flags to be passed to the checker, one
option per line (cf. |syntastic-config-files|).
*'g:syntastic_objc_include_dirs'*
Type: array of strings
Default: []
Include directories to be passed to the checker, in addition to the above
compilation flags. You can set it like this: >
let g:syntastic_objc_include_dirs = ["includes", "headers"]
<
and the corresponding "-Iincludes -Iheaders" will be added to the compilation
flags.
*'g:syntastic_objc_no_default_include_dirs'*
Type: boolean
Default: 0
By default syntastic adds a number of common include directories to the
compilation flags, namely: >
-I. -I.. -Iinclude -Iincludes -I../include -I../includes
<
You can disable this behaviour by setting the above variable to 1.
*'b:syntastic_objc_cflags'*
Type: string
Default: unset
Buffer-local variable. Additional compilation flags specific to the current
buffer.
*'g:syntastic_objc_check_header'*
Type: boolean
Default: 0
If the current file is a header (namely if its extension is "h"), all checks
are silently skipped. You can force syntastic to check header files by
setting the above variable to 1.
Note~
This checker doesn't call the "makeprgBuild()" function, and thus it ignores
the usual 'g:syntastic_objc_gcc_<option>' variables. The only exception is
'g:syntastic_objc_gcc_exec', which can still be used to override the checker's
executable.
See also: |syntastic-objcpp-gcc|.
------------------------------------------------------------------------------
2. OClint *syntastic-objc-oclint*
Name: oclint
Maintainer: "UnCO" Lin <undercooled@lavabit.com>
"OClint" is a static code analysis tool. See the project's page for details:
http://oclint.org/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Additionally:
'g:syntastic_oclint_config_file'
Type: string
Default: ".syntastic_oclint_config"
File containing compilation flags (such as defines or include directories),
one option per line (cf. |syntastic-config-files|).
See also: |syntastic-objcpp-oclint|.
==============================================================================
SYNTAX CHECKERS FOR OBJECTIVE-C++ *syntastic-checkers-objcpp*
The following checkers are available for Objective-C++ (filetype "objcpp"):
1. GCC......................|syntastic-objcpp-gcc|
2. OClint...................|syntastic-objcpp-oclint|
------------------------------------------------------------------------------
1. GCC *syntastic-objcpp-gcc*
Name: gcc
Maintainer: Gregor Uhlenheuer <kongo2002@gmail.com>
Checker options~
*'g:syntastic_objcpp_compiler'*
Type: string
Default: "gcc", or "clang" if GCC is not found
Compiler executable.
*'g:syntastic_objcpp_errorformat'*
Type: string
Default: unset
Override for the default |'errorformat'|.
*'g:syntastic_objcpp_remove_include_errors'*
Type: boolean
Default: 0
By default, errors in files included from the file being checked are shown.
Set this variable to 1 to remove messages about errors in included files.
Please note that this means syntastic will silently abort checks if there are
fatal errors in one of the included files.
*'g:syntastic_objcpp_compiler_options'*
Type: string
Default: unset
Compilation flags (such as defines or include directories) to be passed to the
checker.
*'g:syntastic_objcpp_config_file'*
Type: string
Default: ".syntastic_objcpp_config"
File containing additional compilation flags to be passed to the checker, one
option per line (cf. |syntastic-config-files|).
*'g:syntastic_objcpp_include_dirs'*
Type: array of strings
Default: []
Include directories to be passed to the checker, in addition to the above
compilation flags. You can set it like this: >
let g:syntastic_objcpp_include_dirs = ["includes", "headers"]
<
and the corresponding "-Iincludes -Iheaders" will be added to the compilation
flags.
*'g:syntastic_objcpp_no_default_include_dirs'*
Type: boolean
Default: 0
By default syntastic adds a number of common include directories to the
compilation flags, namely: >
-I. -I.. -Iinclude -Iincludes -I../include -I../includes
<
You can disable this behaviour by setting the above variable to 1.
*'b:syntastic_objcpp_cflags'*
Type: string
Default: unset
Buffer-local variable. Additional compilation flags specific to the current
buffer.
*'g:syntastic_objcpp_check_header'*
Type: boolean
Default: 0
If the current file is a header (namely if its extension is "h"), all checks
are silently skipped. You can force syntastic to check header files by
setting the above variable to 1.
Note~
This checker doesn't call the "makeprgBuild()" function, and thus it ignores
the usual 'g:syntastic_objcpp_gcc_<option>' variables. The only exception
is 'g:syntastic_objcpp_gcc_exec', which can still be used to override the
checker's executable.
See also: |syntastic-objc-gcc|.
------------------------------------------------------------------------------
2. OClint *syntastic-objcpp-oclint*
Name: oclint
Maintainer: "UnCO" Lin <undercooled@lavabit.com>
"OClint" is a static code analysis tool. See the project's page for details:
http://oclint.org/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Additionally:
'g:syntastic_oclint_config_file'
Type: string
Default: ".syntastic_oclint_config"
File containing compilation flags (such as defines or include directories),
one option per line (cf. |syntastic-config-files|).
See also: |syntastic-objc-oclint|.
==============================================================================
SYNTAX CHECKERS FOR OCAML *syntastic-checkers-ocaml*
The following checkers are available for OCaml (filetype "ocaml"):
1. camlp4o..................|syntastic-ocaml-camlp4o|
------------------------------------------------------------------------------
1. camlp4o *syntastic-ocaml-camlp4o*
Name: camlp4o
Maintainer: Tőrők Edwin <edwintorok@gmail.com>
"ocamlc" is a compiler for Caml. See the project's page for details:
http://caml.inria.fr/
Checker options~
*'g:syntastic_ocaml_use_ocamlc'*
Type: boolean
Default: 0
Enable this variable to use "ocamlc".
*'g:syntastic_ocaml_use_janestreet_core'*
Type: boolean
Default: 0
It's possible to use "ocamlc" in conjunction with Jane Street's "core". In
order to do that you have to set the above variable.
*'g:syntastic_ocaml_janestreet_core_dir'*
Type: string
Default: "."
Path to Jane Street's "core".
*'g:syntastic_ocaml_camlp4r'*
Type: boolean
Default: 0
By default, .ml and .mli files are checked with the "camlp4o" preprocessor,
.mll with "ocamllex", and .mly with "menhir". If your source code requires
"camlp4r" you can set this variable.
*'g:syntastic_ocaml_use_ocamlbuild'*
Type: boolean
Default: 0
Whether to enable typechecking and syntax extensions. This tells syntastic to
run "ocamlbuild <name>.inferred.mli". It writes object files to the "_build"
directory, and possibly rebuilds your "myocamlbuild.ml" plugin. If you are
using syntax extensions / external libraries and have a properly set up
"_tags" (and "myocamlbuild.ml" file), setting this flag should just work. For
best results your current directory should be the project root (same situation
if you want useful output from `:make`).
This checker doesn't call the "makeprgBuild()" function, and thus it ignores
the usual 'g:syntastic_ocaml_camlp4o_<option>' variables.
Note~
You might consider using the checkers packaged with Merlin instead of this
one. They provide type errors and let you use packages outside core:
https://github.com/the-lambda-church/merlin
==============================================================================
SYNTAX CHECKERS FOR PERL *syntastic-checkers-perl*
The following checkers are available for Perl (filetype "perl"):
1. perl.....................|syntastic-perl-perl|
2. Perl::Critic.............|syntastic-perl-perlcritic|
3. Pod::Checker.............|syntastic-perl-podchecker|
------------------------------------------------------------------------------
1. perl *syntastic-perl-perl*
Name: perl
Maintainers: Anthony Carapetis <anthony.carapetis@gmail.com>
Eric Harmon
Security~
This checker runs "perl -c" against your files, which in turn executes any
"BEGIN", "UNITCHECK", and "CHECK" blocks, and any "use" statements in your
file (cf. http://perldoc.perl.org/perlrun.html#*-c*). This is probably fine if
you wrote the file yourself, but it can be a problem if you're trying to check
third party files. If you are 100% willing to let Vim run the code in your
file, set 'g:syntastic_enable_perl_checker' to 1 in your vimrc to enable this
checker: >
let g:syntastic_enable_perl_checker = 1
<
There is also a buffer-local version of this variable, that takes precedence
over it in the buffers where it is defined.
Please note that setting this variable doesn't automatically enable the
checker, you still need to add it to 'g:syntastic_perl_checkers' if you plan
to use it.
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Additionally:
*'g:syntastic_perl_interpreter'*
Type: string
Default: "perl"
The perl interpreter to use.
*'g:syntastic_perl_lib_path'*
Type: list os strings
Default: []
List of include directories to be added to the perl command line. Example: >
let g:syntastic_perl_lib_path = [ "./lib", "./lib/auto" ]
<
Note~
The variable |'g:syntastic_perl_interpreter'| is shared with the YAML::XS
checker (cf. |syntastic-yaml-yamlxs|). If for some reasons you don't want to
use the same interpreter for both checkers, you can override it locally by
setting 'g:syntastic_perl_perl_exec'.
------------------------------------------------------------------------------
2. Perl::Critic *syntastic-perl-perlcritic*
Name: perlcritic
Maintainer: LCD 47 <lcd047@gmail.com>
"Perl::Critic" is a static analyzer for Perl. See the project's page for
details:
http://perlcritic.com/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Additionally:
*'g:syntastic_perl_perlcritic_thres'*
Type: integer
Default: 5
Error threshold: policy violations with a severity above this value are
highlighted as errors, the others are warnings.
Note~
You can override the format of "perlcritic" messages, for example: >
let g:syntastic_perl_perlcritic_post_args =
\ '--verbose "\%s:\%f:\%l:\%c: \%p: \%m\n"'
<
Just make sure to leave alone the leading "\%s:\%f:\%l:\%c:".
------------------------------------------------------------------------------
3. Pod::Checker *syntastic-perl-podchecker*
Name: podchecker
Maintainer: LCD 47 <lcd047@gmail.com>
"Pod::Checker" is a checker for pod documents. See the module's manual for
details:
http://perldoc.perl.org/Pod/Checker.html
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
See also: |syntastic-pod-podchecker|.
==============================================================================
SYNTAX CHECKERS FOR PHP *syntastic-checkers-php*
The following checkers are available for PHP (filetype "php"):
1. PHP......................|syntastic-php-php|
2. PHP_CodeSniffer..........|syntastic-php-phpcs|
3. PHPLint..................|syntastic-php-phplint|
4. PHP Mess Detector........|syntastic-php-phpmd|
------------------------------------------------------------------------------
1. PHP *syntastic-php-php*
Name: php
Maintainer: Martin Grenfell <martin.grenfell@gmail.com>
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
------------------------------------------------------------------------------
2. PHP_CodeSniffer *syntastic-php-phpcs*
Name: phpcs
Maintainer: Martin Grenfell <martin.grenfell@gmail.com>
"PHP_CodeSniffer" is a style checker for PHP and CSS. See the project's page
at GitHub for details:
https://github.com/squizlabs/PHP_CodeSniffer/
Installation~
Install it with: >
pear install PHP_CodeSniffer
<
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
Note~
If you're checking files containing tab characters then "PHP_CodeSniffer"'s
idea of tabstop must match Vim's 'tabstop', otherwise syntastic will highlight
the errors at shifted positions. By default syntastic does that by adding
an option "--tab-width=&tabstop" to "PHP_CodeSniffer", but that option
also instructs "PHP_CodeSniffer" to expand tabs, and some code sniffers
(f.i. "CakePHP", see https://github.com/cakephp/cakephp-codesniffer) insist on
indenting lines with tabs. To work around the resulting mess if you're using
one of these sniffers, set "--tab-width=0" and 'tabstop' to 8: >
let g:syntastic_php_phpcs_args = "--tab-width=0"
set tabstop=8
<
See also: |syntastic-css-phpcs|.
------------------------------------------------------------------------------
3. PHPLint *syntastic-php-phplint*
Name: phplint
Maintainer: LCD 47 <lcd047@gmail.com>
"PHPLint" is a style checker for PHP. See the project's page for details:
http://www.icosaedro.it/phplint/
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
------------------------------------------------------------------------------
4. PHP Mess Detector *syntastic-php-phpmd*
Name: phpmd
Maintainer: Martin Grenfell <martin.grenfell@gmail.com>
"PHP Mess Detector" is a code analyzer for PHP. See the project's page for
details:
http://phpmd.org
Checker options~
This checker is initialised using the "makeprgBuild()" function and thus it
accepts the standard options described at |syntastic-config-makeprg|.
==============================================================================
SYNTAX CHECKE