#### LSP based completers

The LSP servers sometimes support user configurations. To learn what
configurations are available, consult the respective LSP server's documentation.

- `ls`: (optional) a dictionary where all LSP server specific settings reside.

Example of LSP configuration:
```python
def Settings( **kwargs ):
  if kwargs[ 'language' ] == 'java':
    return { 'ls': { 'java.rename.enabled' : False } }
```

A special user option `language_server` can be used to plug in a LSP server ycmd
wouldn't usually know about. The value is a dictionary whose keys are languages
and values are lists of command lines to execute the server. Example:

```json
{ "language_server": { "go": [ "/path/to/gopls", "-rpc.trace" ] } }
```

When plugging in a completer in this way, the `kwargs[ 'language' ]` will be set
to the key of `language_server` user option.

LSP completers currecntly supported without `language_server`:

- Java
- Rust
- Go
- C-family