Some completion engines are disabled in this package. But you can still use them
with some additional work.

List of supported semantic code completion engines in this package:

| Language       | Engine                 | Status                     |
|----------------|------------------------|----------------------------|
| C/C++          | libclang1              | Supported out of the box   |
| C/C++          | clangd                 | Supported out of the box   |
| Python 2 & 3   | python3-jedi           | Supported out of the box   |
| TypeScript     | node-typescript        | Supported out of the box   |
| JavaScript     | node-typescript or tern| Supported out of the box   |
| Go             | gopls                  | See Go completion          |
| Rust           | rls                    | See Rust completion        |
| C#             | OmniSharp-roslyn       | See C# completion          |

Java completion
---------------

Upstream considers the support experimental. The jdt.ls engine is currently not
packaged in Debian so far and even supporting unpackaged versions seems difficult.
If you are interested and willing to supply a patch you are more than welcome.


C# completion
-------------

You will need at least mono and OmniSharp.exe from the omnisharp-roslyn project.
A patch is included to allow the exe to be placed in /usr/local/bin, but this
completion is currently not tested for Debian. Feel free to provide feedback
if you made it work.


Go completion
-------------

Installing 'golang' and running 'GO111MODULE=on go get golang.org/x/tools/gopls@latest'
as the user which should have the completion available should download and install
gopls in ~/go/bin/gopls which this version of ycmd is patch to support.


Rust completion
---------------

Setting up rls seems to require rustup – both not being available in Debian so far,
so Rust completion is currently not tested nor supported in Debian.
If you are interested and willing to supply a patch you are more than welcome.



JavaScript completion
---------------------

Support for the old Tern-based completer you could install with npm in your
home directory is still included and will be used if present for backward-
compatibility, but upstream recommends and uses for new users the tsserver-
based completer provided by the node-typescript package in Debian.
