summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--README.md3
-rw-r--r--docs/faq.md34
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,