diff --git a/doc/org-roam.org b/doc/org-roam.org index 1bc27da..0a9cf84 100644 --- a/doc/org-roam.org +++ b/doc/org-roam.org @@ -1285,6 +1285,17 @@ file within that directory, at least once. Fabio has produced a command-line tool that converts markdown files exported from Roam Research into Org-roam compatible markdown. More instructions are provided [[https://github.com/fabioberger/roam-migration][in the repository]]. +** How do I create a note whose title already matches one of the candidates? + +This situation arises when, for example, one would like to create a note titled +"bar" when "barricade" already exists. + +The solution is dependent on the mini-buffer completion framework in use. Here +are the solutions: + +- Ivy :: call ~ivy-immediate-done~, typically bound to ~C-M-j~. Alternatively, set ~ivy-use-selectable-prompt~ to ~t~, so that "bar" is now selectable. +- Helm :: Org-roam should provide a selectable "[?] bar" candidate at the top of the candidate list. + # Local Variables: # eval: (require 'ol-info) # before-save-hook: org-make-toc diff --git a/doc/org-roam.texi b/doc/org-roam.texi index 44845bf..8953145 100644 --- a/doc/org-roam.texi +++ b/doc/org-roam.texi @@ -151,6 +151,7 @@ FAQ * How do I have more than one Org-roam directory?:: * How do I migrate from Roam Research?:: +* How do I create a note whose title already matches one of the candidates?:: @end detailmenu @end menu @@ -1627,6 +1628,7 @@ files. Other alternatives include @uref{https://orgmode.org/worg/org-contrib/org @menu * How do I have more than one Org-roam directory?:: * How do I migrate from Roam Research?:: +* How do I create a note whose title already matches one of the candidates?:: @end menu @node How do I have more than one Org-roam directory? @@ -1654,5 +1656,21 @@ file within that directory, at least once. Fabio has produced a command-line tool that converts markdown files exported from Roam Research into Org-roam compatible markdown. More instructions are provided @uref{https://github.com/fabioberger/roam-migration, in the repository}. +@node How do I create a note whose title already matches one of the candidates? +@section How do I create a note whose title already matches one of the candidates? + +This situation arises when, for example, one would like to create a note titled +``bar'' when ``barricade'' already exists. + +The solution is dependent on the mini-buffer completion framework in use. Here +are the solutions: + +@table @asis +@item Ivy +call @code{ivy-immediate-done}, typically bound to @code{C-M-j}. Alternatively, set @code{ivy-use-selectable-prompt} to @code{t}, so that ``bar'' is now selectable. +@item Helm +Org-roam should provide a selectable ``[?] bar'' candidate at the top of the candidate list. +@end table + Emacs 28.0.50 (Org mode 9.4) @bye