(docs): clarify org-roam-completion-system (#948)

master
Jethro Kuan 6 years ago committed by GitHub
parent 10e91a88c1
commit fb5beeb14d
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
  1. 12
      doc/org-roam.org
  2. 12
      doc/org-roam.texi

@ -645,15 +645,19 @@ This setting excludes all files whose path contain "private" or "dailies".
* Org-roam Completion System
Org-roam offers completion when choosing note titles etc. The completion
system is configurable. The default setting,
Org-roam allows customization of which minibuffer completion system to use for
its interactive commands. The default setting uses Emacs' standard
~completing-read~ mechanism.
#+BEGIN_SRC emacs-lisp
(setq org-roam-completion-system 'default)
#+END_SRC
uses Emacs' standard ~completing-read~. If you prefer
[[https://emacs-helm.github.io/helm/][Helm]], use
If you have installed Helm or Ivy, and have their modes enabled, under the
~'default~ setting they will be used.
In the rare scenario where you use Ivy globally, but prefer [[https://emacs-helm.github.io/helm/][Helm]] for org-roam
commands, set:
#+BEGIN_SRC emacs-lisp
(setq org-roam-completion-system 'helm)

@ -921,15 +921,19 @@ This setting excludes all files whose path contain ``private'' or ``dailies''.
@node Org-roam Completion System
@chapter Org-roam Completion System
Org-roam offers completion when choosing note titles etc. The completion
system is configurable. The default setting,
Org-roam allows customization of which minibuffer completion system to use for
its interactive commands. The default setting uses Emacs' standard
@code{completing-read} mechanism.
@lisp
(setq org-roam-completion-system 'default)
@end lisp
uses Emacs' standard @code{completing-read}. If you prefer
@uref{https://emacs-helm.github.io/helm/, Helm}, use
If you have installed Helm or Ivy, and have their modes enabled, under the
@code{'default} setting they will be used.
In the rare scenario where you use Ivy globally, but prefer @uref{https://emacs-helm.github.io/helm/, Helm} for org-roam
commands, set:
@lisp
(setq org-roam-completion-system 'helm)

Loading…
Cancel
Save