# HG changeset patch
# User František Kučera <franta-hg@frantovo.cz>
# Date 1544288917 -3600
# Node ID 8dd5b7ecb7367813d5855f61fc7f3a67e7b6b6e8
# Parent  65138c5d5a7c6b8b78b63ba86aaafc9c299bb3a8
examples: multiple relations in a single stream

diff -r 65138c5d5a7c -r 8dd5b7ecb736 relpipe-data/examples.xml
--- a/relpipe-data/examples.xml	Fri Dec 07 22:01:46 2018 +0100
+++ b/relpipe-data/examples.xml	Sat Dec 08 18:08:37 2018 +0100
@@ -53,6 +53,33 @@
 			and then their definitions (names and types),
 			followed by the data.
 		</p>
+
+		<p>
+			A single stream may contain multiple relations:
+		</p>		
+		
+		<m:pre jazyk="bash"><![CDATA[(relpipe-in-cli generate a 1 x string hello; \
+ relpipe-in-cli generate b 1 y string world) \
+	| relpipe-out-tabular]]></m:pre>
+			
+		<p>
+			Thus we can combine various commands or files and pass the result to a single relational output filter (<code>relpipe-out-tabular</code> in this case) and get:
+		</p>
+		
+		<pre><![CDATA[a:
+ ╭────────────╮
+ │ x (string) │
+ ├────────────┤
+ │ hello      │
+ ╰────────────╯
+Record count: 1
+b:
+ ╭────────────╮
+ │ y (string) │
+ ├────────────┤
+ │ world      │
+ ╰────────────╯
+Record count: 1]]></pre>
 		
 		<h3>relpipe-in-cli: STDIN</h3>