From b2323ca203e99e281cae4ada6ccdc1799de1f5f9 Mon Sep 17 00:00:00 2001
From: Fabian Homborg <FHomborg@gmail.com>
Date: Fri, 11 Sep 2015 21:05:55 +0200
Subject: [PATCH] commandline docs: Add examples for the filters

i.e. "-t", "-b", "-j" and "-p"
---
 doc_src/commandline.txt | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

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