diff --git a/doc_src/commandline.txt b/doc_src/commandline.txt
index 347f48700..54869fa96 100644
--- a/doc_src/commandline.txt
+++ b/doc_src/commandline.txt
@@ -57,3 +57,24 @@ The following options output metadata about the commandline state:
 \subsection commandline-example Example
 
 `commandline -j $history[3]` replaces the job under the cursor with the third item from the command line history.
+
+If the commandline contains
+\fish
+>_ echo $fl___ounder >&2 | less; and echo $catfish
+\endfish
+
+(with the cursor on the "o" of "flounder")
+
+Then the following invocations behave like this:
+\fish
+>_ commandline -t
+$flounder
+>_ commandline -ct
+$fl
+>_ commandline -b # or just commandline
+echo $flounder >&2 | less; and echo $catfish
+>_ commandline -p
+echo $flounder >&2
+>_ commandline -j
+echo $flounder >&2 | less
+\endfish