This plugin provides a completion source for the popular Emacs interactive auto-completion framework auto-complete.
Where slime provides it, pop-up documentation for completed symbols will be displayed.
First, ensure auto-complete and slime are installed: I recommend
using packages from MELPA. cl-lib
is also required -- it's built into recent Emacs versions, and a
backport package is available in GNU ELPA for users
of older Emacs versions.
You'll need both auto-complete and slime to be enabled and
working, so please consult the corresponding documentation is you have
any trouble with this.
Next, install ac-slime. If you choose not to use the convenient
package in MELPA, you'll need to add the directory containing
ac-slime.el to your load-path, and then (require 'ac-slime).
ac-slime provides a couple of slime-specific completion sources,
so auto-complete needs to be told to use them when slime-mode is
active. To do this, put the following code in your emacs init file to
(add-hook 'slime-mode-hook 'set-up-slime-ac)
(add-hook 'slime-repl-mode-hook 'set-up-slime-ac)
(eval-after-load "auto-complete"
'(add-to-list 'ac-modes 'slime-repl-mode))
ac-slime should now automatically be enabled when you visit a buffer
in which slime-mode is active and auto-complete is enabled. (The
symbols "Slime" and "AC" should appear in the modeline.)
Simply trigger auto-completion, and completion candidates supplied by
slime should be displayed, with the symbol l on the right hand side
of the completion pop-up. After a short delay, popup documentation
for the completed symbol should also be displayed.
ac-slime supports fuzzy completion -- see the comments in
ac-slime.el for details. Note that to use fuzzy completion, you must
install and require slime-fuzzy.el, which comes with the full Slime
distro.
