diff --git a/doc/org-roam.org b/doc/org-roam.org index 5ce7b55..d196800 100644 --- a/doc/org-roam.org +++ b/doc/org-roam.org @@ -468,6 +468,9 @@ can set ~org-roam-node-display-template~ as such: * Customizing Node Caching ** How to cache +:PROPERTIES: +:ID: 280bfca8-83f3-4371-bc3a-25478d25129c +:END: Org-roam uses a sqlite database to perform caching, but there are multiple Emacs libraries that can be used. The default used by Org-roam is ~emacs-sqlite~. @@ -1618,6 +1621,20 @@ to the publishing directory. Example code follows: (kill-buffer (file-name-nondirectory svg)) (setq my-publish-time 0))))) #+end_src +** I'm seeing this "Selecting deleted buffer" error. What do I do? + +The "selecting deleted buffer" error usually occurs when you don't have a +working ~emacsql-sqlite~ executable. Org-roam relies on this executable to +function properly, and doesn't catch this error. This issue is most commonly +seen on Windows setups. You can browse through the various GitHub issues posted +about this [[https://github.com/org-roam/org-roam/issues?q=is%3Aissue+selecting+deleted][here]]. + +To fix this, you can try the following: + +1. If on Windows, try replacing your system binary with [[https://github.com/nobiot/emacsql-sqlite.exe][this one]] that has been proven + to work +2. Use the ~emacsql-sqlite3~ option rather than compiling your own emacsql + binary (see [[id:280bfca8-83f3-4371-bc3a-25478d25129c][How to cache]]). * Developer's Guide to Org-roam ** Org-roam's Design Principle diff --git a/doc/org-roam.texi b/doc/org-roam.texi index fc4dbb0..421746a 100644 --- a/doc/org-roam.texi +++ b/doc/org-roam.texi @@ -195,6 +195,7 @@ FAQ * How do I migrate from Roam Research?:: * How to migrate from Org-roam v1?:: * How do I publish my notes with an Internet-friendly graph?:: +* I'm seeing this ``Selecting deleted buffer'' error. What do I do?: I'm seeing this ``Selecting deleted buffer'' error What do I do?. How do I publish my notes with an Internet-friendly graph? @@ -2023,6 +2024,7 @@ Org-mode, and sync your cards to Anki via @uref{https://github.com/FooSoft/anki- * How do I migrate from Roam Research?:: * How to migrate from Org-roam v1?:: * How do I publish my notes with an Internet-friendly graph?:: +* I'm seeing this ``Selecting deleted buffer'' error. What do I do?: I'm seeing this ``Selecting deleted buffer'' error What do I do?. @end menu @node How do I have more than one Org-roam directory? @@ -2233,6 +2235,27 @@ to the publishing directory. Example code follows: (setq my-publish-time 0))))) @end lisp +@node I'm seeing this ``Selecting deleted buffer'' error What do I do? +@section I'm seeing this ``Selecting deleted buffer'' error. What do I do? + +The ``selecting deleted buffer'' error usually occurs when you don't have a +working @code{emacsql-sqlite} executable. Org-roam relies on this executable to +function properly, and doesn't catch this error. This issue is most commonly +seen on Windows setups. You can browse through the various GitHub issues posted +about this @uref{https://github.com/org-roam/org-roam/issues?q=is%3Aissue+selecting+deleted, here}. + +To fix this, you can try the following: + +@itemize +@item +If on Windows, try replacing your system binary with @uref{https://github.com/nobiot/emacsql-sqlite.exe, this one} that has been proven +to work + +@item +Use the @code{emacsql-sqlite3} option rather than compiling your own emacsql +binary (see @ref{How to cache}). +@end itemize + @node Developer's Guide to Org-roam @chapter Developer's Guide to Org-roam