]> git.madduck.net Git - etc/vim.git/blobdiff - .vim/bundle/ale/doc/ale-sh.txt

madduck's git repository

Every one of the projects in this repository is available at the canonical URL git://git.madduck.net/madduck/pub/<projectpath> — see each project's metadata for the exact URL.

All patches and comments are welcome. Please squash your changes to logical commits before using git-format-patch and git-send-email to patches@git.madduck.net. If you'd read over the Git project's submission guidelines and adhered to them, I'd be especially grateful.

SSH access, as well as push access can be individually arranged.

If you use my repositories frequently, consider adding the following snippet to ~/.gitconfig and using the third clone URL listed for each project:

[url "git://git.madduck.net/madduck/"]
  insteadOf = madduck:

Merge commit '76265755a1add77121c8f9dabb3e9bb70fe9a972' as '.vim/bundle/ale'
[etc/vim.git] / .vim / bundle / ale / doc / ale-sh.txt
diff --git a/.vim/bundle/ale/doc/ale-sh.txt b/.vim/bundle/ale/doc/ale-sh.txt
new file mode 100644 (file)
index 0000000..cc2e424
--- /dev/null
@@ -0,0 +1,169 @@
+===============================================================================
+ALE Shell Integration                                          *ale-sh-options*
+
+
+===============================================================================
+bashate                                                        *ale-sh-bashate*
+
+                                            *ale-options.sh_bashate_executable*
+                                                  *g:ale_sh_bashate_executable*
+                                                  *b:ale_sh_bashate_executable*
+sh_bashate_executable
+g:ale_sh_bashate_executable
+  Type: |String|
+  Default: `'bashate'`
+
+  This variable sets executable used for bashate.
+
+                                               *ale-options.sh_bashate_options*
+                                                     *g:ale_sh_bashate_options*
+                                                     *b:ale_sh_bashate_options*
+sh_bashate_options
+g:ale_sh_bashate_options
+  Type: |String|
+  Default: `''`
+
+  With this variable we are able to pass extra arguments for bashate. For
+  example to ignore the indentation rule: >
+
+  let g:ale_sh_bashate_options = '-i E003'
+<
+
+===============================================================================
+cspell                                                          *ale-sh-cspell*
+
+See |ale-cspell-options|
+
+
+===============================================================================
+sh-language-server                                     *ale-sh-language-server*
+
+                                    *ale-options.sh_language_server_executable*
+                                          *g:ale_sh_language_server_executable*
+                                           *b:ale_sh_language_server_executable*
+sh_language_server_executable
+g:ale_sh_language_server_executable
+  Type: |String|
+  Default: `'bash-language-server'`
+
+  See |ale-integrations-local-executables|
+
+                                    *ale-options.sh_language_server_use_global*
+                                          *g:ale_sh_language_server_use_global*
+                                           *b:ale_sh_language_server_use_global*
+sh_language_server_use_global
+g:ale_sh_language_server_use_global
+  Type: |Number|
+  Default: `get(g:, 'ale_use_global_executables', 0)`
+
+  See |ale-integrations-local-executables|
+
+
+===============================================================================
+shell                                                            *ale-sh-shell*
+
+                                           *ale-options.sh_shell_default_shell*
+                                                 *g:ale_sh_shell_default_shell*
+                                                 *b:ale_sh_shell_default_shell*
+sh_shell_default_shell
+g:ale_sh_shell_default_shell
+  Type: |String|
+  Default: The current shell (`$SHELL`). Falls back to `'bash'` if that cannot be
+  read or if the current shell is `'fish'`.
+
+  When ALE runs the linter for shells with the `-n` flag, it will attempt to
+  read the shell from the shebang (`#!`) line from the shell script to
+  determine the shell program to run. When this detection fails, this variable
+  will be used instead.
+
+
+===============================================================================
+shellcheck                                                  *ale-sh-shellcheck*
+
+                                         *ale-options.sh_shellcheck_executable*
+                                               *g:ale_sh_shellcheck_executable*
+                                               *b:ale_sh_shellcheck_executable*
+sh_shellcheck_executable
+g:ale_sh_shellcheck_executable
+  Type: |String|
+  Default: `'shellcheck'`
+
+  This variable sets executable used for shellcheck.
+
+                                            *ale-options.sh_shellcheck_options*
+                                                  *g:ale_sh_shellcheck_options*
+                                                  *b:ale_sh_shellcheck_options*
+sh_shellcheck_options
+g:ale_sh_shellcheck_options
+  Type: |String|
+  Default: `''`
+
+  With this variable we are able to pass extra arguments for shellcheck
+  for shellcheck invocation.
+
+  For example, if we want shellcheck to follow external sources (`see SC1091`)
+  we can set the variable as such: >
+
+  let g:ale_sh_shellcheck_options = '-x'
+<
+                                   *ale-options.sh_shellcheck_change_directory*
+                                         *g:ale_sh_shellcheck_change_directory*
+                                         *b:ale_sh_shellcheck_change_directory*
+sh_shellcheck_change_directory
+g:ale_sh_shellcheck_change_directory
+  Type: |Number|
+  Default: `1`
+
+  If set to `1`, ALE will switch to the directory the shell file being
+  checked with `shellcheck` is in before checking it. This helps `shellcheck`
+  determine the path to sourced files more easily. This option can be turned
+  off if you want to control the directory `shellcheck` is executed from
+  yourself.
+
+                                            *ale-options.sh_shellcheck_dialect*
+                                                  *g:ale_sh_shellcheck_dialect*
+                                                  *b:ale_sh_shellcheck_dialect*
+sh_shellcheck_dialect
+g:ale_sh_shellcheck_dialect
+  Type: |String|
+  Default: `'auto'`
+
+  This variable specifies the shellcheck dialect (`-s` option).  The value
+  `'auto'` causes ALE to detect the dialect automatically, based on the shebang
+  line (if present) or the value of `b:is_bash`, `b:is_sh`, or `b:is_kornshell`
+  (set and used by |sh.vim|).
+
+                                         *ale-options.sh_shellcheck_exclusions*
+                                               *g:ale_sh_shellcheck_exclusions*
+                                               *b:ale_sh_shellcheck_exclusions*
+sh_shellcheck_exclusions
+g:ale_sh_shellcheck_exclusions
+  Type: |String|
+  Default: `''`
+
+  Set this variable to exclude test(s) for shellcheck (-e/--exclude option).
+  To exclude more than one option, separate them with commas.
+
+  For example, to ignore some warnings that aren't applicable to files that
+  will be sourced by other scripts, use the buffer-local variant: >
+
+    autocmd BufEnter PKGBUILD,.env
+    \   let b:ale_sh_shellcheck_exclusions = 'SC2034,SC2154,SC2164'
+<
+
+===============================================================================
+shfmt                                                            *ale-sh-shfmt*
+
+                                                 *ale-options.sh_shfmt_options*
+                                                       *g:ale_sh_shfmt_options*
+                                                       *b:ale_sh_shfmt_options*
+sh_shfmt_options
+g:ale_sh_shfmt_options
+  Type: |String|
+  Default: `''`
+
+  This variable can be set to pass additional options to the shfmt fixer.
+
+
+===============================================================================
+  vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl: