This repository has been archived on 2024-10-22. You can view files and clone it, but cannot push or open issues or pull requests.
spacemacs/contrib/tools/ycmd/README.md
2015-04-26 00:44:18 -04:00

55 lines
1.6 KiB
Markdown

# YCMD contribution layer for Spacemacs
<!-- markdown-toc start - Don't edit this section. Run M-x markdown-toc/generate-toc again -->
**Table of Contents**
- [YCMD contribution layer for Spacemacs](#ycmd-contribution-layer-for-spacemacs)
- [Description](#description)
- [Install](#install)
- [Layer](#layer)
- [YCMD](#ycmd)
- [Other Requirements](#other-requirements)
- [Configuration](#configuration)
- [Key Bindings](#key-bindings)
<!-- markdown-toc end -->
## Description
This layer adds [emacs-ycmd][] support.
## Install
### Layer
To use this contribution add it to your `~/.spacemacs`
```elisp
(setq-default dotspacemacs-configuration-layers '(ycmd))
```
### YCMD
In order to use this layer you must have a local [ycmd][] installation and must
set the `ycmd-server-command` variable to reflect the path to that installation.
See the [emacs-ycmd][] readme for more instructions on this.
### Other Requirements
This package requires the `auto-completion` layer in order to get actual
completion. The `syntax-checking` layer is required for flycheck support.
## Configuration
By default this layer only activates ycmd for `c++-mode`.
If you want ycmd suppoert in other modes you might just want to add it for
specific languages like: ```elisp (add-hook 'c++-mode-hook 'ycmd-mode) ```
## Key Bindings
Adds `SPC m g g` go to definition binding to `c++-mode` as well as `SPC m g G`
for the more imprecise but faster version.
[ycmd]: https://github.com/Valloric/ycmd#building
[emacs-ycmd]: https://github.com/abingham/emacs-ycmd