From 72c1b18a081febed7147d9e1854611dce5a42006 Mon Sep 17 00:00:00 2001
From: Mathieu Ablasou <alexherbo2@gmail.com>
Date: Mon, 23 Nov 2020 18:08:17 +0100
Subject: =?UTF-8?q?FAQ:=20I=20don=E2=80=99t=20have=20a=20`popup`=20command?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md   |  3 +++
 docs/faq.md | 34 ++++++++++++++++++++++++++++++++++
 2 files changed, 37 insertions(+)

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,
-- 
cgit v1.2.3