aboutsummaryrefslogtreecommitdiff
blob: 5cb40098c42391eba516728028ccfac6482a8a76 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
=============
gentoo-syntax
=============

A vim plugin that handles Gentoo and portage related syntax highlighting,
filetype, and indent settings.

Installing
==========

* Gentoo users: ``emerge app-vim/gentoo-syntax``
* Everyone else: ``make PREFIX=~/.vim/ install``

Syntastic
---------

This plugin provides a syntax checker for ebuilds and eclasses. To enable it,
you need to install Syntastic_ and pkgcheck_ first::

    # emerge app-vim/syntastic dev-util/pkgcheck

Then you'll need to configure Syntastic (see ``:help syntastic-quickstart``)
and add the following line to your .vimrc file::

    let g:syntastic_ebuild_checkers = ['pkgcheck']

To find non-POSIX code in OpenRC services, install ``dev-util/checkbashisms``
and enable it for filetype "sh"::

    let g:syntastic_sh_checkers = ['sh', 'checkbashisms']

.. _Syntastic: https://github.com/vim-syntastic/syntastic
.. _pkgcheck:  https://github.com/pkgcore/pkgcheck

Asynchronous Lint Engine
------------------------

A pkgcheck-based linter for ALE_ is also installed. It will be enabled
automatically if pkgcheck_ is installed, no manual action is required.

.. _ALE: https://github.com/dense-analysis/ale

Bugs
====

Please file issues or submit pull requests on github_.

.. _github: https://github.com/gentoo/gentoo-syntax

License
=======

You may redistribute this package under the same terms as Vim itself.