Add support for -shell-script-* completion in :prompt

Fixes #2754

1 files changed, 9 insertions, 0 deletions

diff --git a/doc/pages/commands.asciidoc b/doc/pages/commands.asciidoc
index d4eda26a..8a215e3d 100644
--- a/doc/pages/commands.asciidoc
+++ b/doc/pages/commands.asciidoc
@@ -247,6 +247,15 @@ but not really useful in that context.
     will have this command executed whenever the prompt content changes
     or the prompt is aborted, respectively.
 
+    Completion support can be controlled with the same switches provided
+    by the *define-command* command, see
+    <<declaring-new-commands,Declaring new commands>>.
+
+    For *-shell-script-completions* and *-shell-script-candidates*
+    completions, token_to_complete will always be 1, and the full
+    prompt content will be passed as a single token. In other words,
+    word splitting does not take place.
+
 *on-key* <command>::
     wait for next key from user, then execute <command>, the key is
     available through the `key` value, accessible through `$kak_key`