Emacs front-end for RTags
-------------------------

The Emacs front-end includes number of packages. Main package is
`elpa-rtags` which communicates to the rtags daemon and provides
functionality like "follow symbol under cursor", "find references at
point" etc.

A sample configuration for `.emacs`:

    (use-package rtags
      :config
      (rtags-enable-standard-keybindings)
      (add-hook 'c++-mode-hook '(lambda ()
                                  (local-set-key [f9] 'rtags-compile-file))))

The functionality of `elpa-rtags` package could be enhanced. To enable
code completion with `company` or `auto-complete` mode install and
configure `elpa-company-rtags` or `elpa-ac-rtags` correspondingly:

    (use-package company-rtags
      :config
      (setq rtags-completions-enabled t)
      (add-hook 'c-mode-common-hook '(lambda ()
                                       (push 'company-rtags company-backends)
                                       (company-mode))))

    (use-package ac-rtags
      :config
      (setq rtags-completions-enabled t)
      (add-hook 'c-mode-common-hook '(lambda ()
                                       (setq-local ac-sources (append '(ac-source-rtags) ac-sources))
                                       (auto-complete-mode))))

To enable flycheck support you need to install and load
`elpa-flycheck-rtags` package:

    (use-package flycheck-rtags
      :config
      (add-hook 'c-mode-common-hook '(lambda ()
                                       (flycheck-select-checker 'rtags)
                                       (flycheck-mode))))

You can use Helm with `elpa-helm-rtags` or Ivy with `elpa-ivy-rtags`
to view the results:

    (use-package helm-rtags
      :config
      (setq rtags-display-result-backend 'helm))

    (use-package ivy-rtags
      :config
      (setq rtags-display-result-backend 'ivy))