diff --git a/docs/fish-config.1 b/docs/fish-config.1
index d95f870..9b4fe3b 100644
--- a/docs/fish-config.1
+++ b/docs/fish-config.1
@@ -604,9 +604,11 @@ Ctrl+Enter      Smart execute: runs commands instantly without
                 pressing Enter a second time for certain fast-path
                 commands (speedtest-fast, etc.).
 
-\[at]\[at]              FZF inline picker. Type \[at]\[at] anywhere on the command
-                line to open an fzf picker and insert a selection
-                at the cursor position.
+\[at]\[at]              FZF inline picker. Type \[at] twice anywhere on the
+                command line to open an fzf picker and replace the
+                \[at]\[at] with the selection. The \[at]\[at] must be typed as its
+                own token: \[dq]cat \[at]\[at]\[dq] triggers it, but \[dq]cat\[at]\[at]\[dq] does
+                not.
 
 Ctrl+Right      Accept autosuggestion one word/directory segment
                 at a time. (Restores Fish 3.x behavior by binding
diff --git a/docs/fish-config.md b/docs/fish-config.md
index 0f1e802..1d3d2b3 100644
--- a/docs/fish-config.md
+++ b/docs/fish-config.md
@@ -338,9 +338,11 @@ are active in Insert, Normal, and Visual modes unless noted.
                     pressing Enter a second time for certain fast-path
                     commands (speedtest-fast, etc.).
 
-    @@              FZF inline picker. Type @@ anywhere on the command
-                    line to open an fzf picker and insert a selection
-                    at the cursor position.
+    @@              FZF inline picker. Type @ twice anywhere on the
+                    command line to open an fzf picker and replace the
+                    @@ with the selection. The @@ must be typed as its
+                    own token: "cat @@" triggers it, but "cat@@" does
+                    not.
 
     Ctrl+Right      Accept autosuggestion one word/directory segment
                     at a time. (Restores Fish 3.x behavior by binding