Jump to documentation buffer with company-mode

Question

I have recently switched from auto-complete-mode to company-mode and I having fun. Recently I had to write some Emacs Lisp code. I start typing my function, completion candidates are shown, I press F1 and the documentation opens up in another buffer. I would like to jump to the documentation buffer, but, as I type C-x o it gets closed. Any hint?

Answer 1

I don't see a way built in to company-mode to do this, but you can add your own key binding to company-active-map.

As a quick experiment I took the company-show-doc-buffer implementation and simply removed the company--electric-do wrapper:

(defun my/company-show-doc-buffer ()
  "Temporarily show the documentation buffer for the selection."
  (interactive)
  (let* ((selected (nth company-selection company-candidates))
         (doc-buffer (or (company-call-backend 'doc-buffer selected)
                         (error "No documentation available"))))
    (with-current-buffer doc-buffer
      (goto-char (point-min)))
    (display-buffer doc-buffer t)))

You could bind this to another key, for example C-F1, to "permanently" open the doc buffer:

    (define-key company-active-map (kbd "C-<f1>") #'my/company-show-doc-buffer)

Answer 2

Author's comment on a page comparing company-mode to auto-complete:

What happens when you press F1 in company mode

It uses pop-to-window to display the help buffer, but hides it before the next command (unless that command is scroll-other-window or scroll-other-window-down).

Based on that, you can only scroll the documentation buffer, not jump to it.

But, looking at the code for company-show-doc-buffer, I noticed that it uses company--electric-do, which will call interactively any commands in company--electric-commands. Normally, it contains only scroll-other-window and scroll-other-window-down, but maybe you can add other-window to that list.