FAQ: I don’t have a `popup` command

2 files changed, 37 insertions, 0 deletions

diff --git a/README.md b/README.md
index ef4d140..a26cff9 100644
--- a/README.md
+++ b/README.md
@@ -176,6 +176,9 @@ require-module connect-fzf
 hook global ModuleLoaded x11 %{
   alias global terminal alacritty
   alias global popup alacritty-popup
+
+  # If your terminal does not have popups, fall back to x11-terminal.
+  # alias global popup x11-terminal
 }
 
 # Explore files and buffers with fzf
diff --git a/docs/faq.md b/docs/faq.md
index c44e3fc..2a8980b 100644
--- a/docs/faq.md
+++ b/docs/faq.md
@@ -1,5 +1,39 @@
 # FAQ
 
+## I don’t have a _popup_ command
+
+Popups (`+`) are used for [`fzf`][fzf.kak] commands.
+
+[fzf.kak]: ../rc/connect/modules/fzf
+
+**Example**
+
+``` kak
++ :fzf
+```
+
+If your terminal does not have popups, you can add a fallback to the underlying terminal.
+
+**Example** – [X11] configuration:
+
+``` kak
+hook global ModuleLoaded x11 %{
+  alias global popup x11-terminal
+}
+```
+
+[X11]: https://x.org
+
+**Example** – [tmux] configuration:
+
+``` kak
+hook global ModuleLoaded tmux %{
+  alias global popup tmux-terminal-vertical
+}
+```
+
+[tmux]: https://github.com/tmux/tmux
+
 ## What is the difference between _>_ and _$_?
 
 The `>` or `connect-terminal` command runs its arguments (by default your shell) inside a connected terminal,