# HG changeset patch
# User František Kučera <franta-hg@frantovo.cz>
# Date 1543593468 -3600
# Node ID 65b71e6a09731b9ac0fea2cef85b02ece62dfe52
# Parent  2be00f14dc78691082d5e1c1912f58832fcd8f0c
specification: relpipe-in-cli

diff -r 2be00f14dc78 -r 65b71e6a0973 relpipe-data/specification.xml
--- a/relpipe-data/specification.xml	Fri Nov 30 16:43:11 2018 +0100
+++ b/relpipe-data/specification.xml	Fri Nov 30 16:57:48 2018 +0100
@@ -56,6 +56,38 @@
 		<h2>Tools</h2>
 		
 		<h3>relpipe-in-cli</h3>
+		<p>
+			A tool that generates a single relation. I we want more relations in a single stream, we just call this command multiple times:
+		</p>
+		
+		<m:pre jazyk="bash"><![CDATA[
+(relpipe-in-cli ... ; relpipe-in-cli ... ; relpipe-in-cli ... ) | relpipe-out-tabular
+]]></m:pre>
+
+		<p>Or concatenate several files or do a combination of both files and commands.</p>
+		
+		<p>This command accept these arguments:</p>
+		
+		<ul>
+			<li>relation name</li>
+			<li>attribute count</li>
+			<li>names of attributes</li>
+			<li>types of attributes</li>
+			<li>attribute values</li>
+		</ul>
+		
+		<p>
+			These data might be passed as CLI arguments on the command line or as null-byte (<code>\0</code>) separated list of values on STDIN.
+			Both ways can be combined e.g. pass relation name and metadata as CLI arguments and the data on STDIN.
+			The tool simply starts with CLI arguments (if any) and continues with values from STDIN (if any).
+		</p>
+		
+		<p>
+			This tool is a good entry point to the <m:name/> world because it requires no programming and construction of the argument list or <code>\0</code> separated list can be done in any language or environment.
+			Tools like <code>perl</code> or <code>tr</code> can convert almost any data to this form and pass it to <code>relpipe-in-cli</code>.
+		</p>
+		
+		
 		<h3>relpipe-in-fstab</h3>
 		<h3>relpipe-out-tabular</h3>
 		<h3>relpipe-out-xml</h3>