relpipe-data/release-v0.17.xml
author František Kučera <franta-hg@frantovo.cz>
Sat, 31 Oct 2020 22:38:32 +0100
branchv_0
changeset 319 2a5f26e69a76
parent 317 fce3d6290c40
child 329 5bc2bb8b7946
permissions -rw-r--r--
Release v0.17.1 – streamlet date example, big numbers fix, GUI charts fix
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
23
0d2729ed16ed zkouška interního odkazu
František Kučera <franta-hg@frantovo.cz>
parents: 18
diff changeset
     1
<stránka
0d2729ed16ed zkouška interního odkazu
František Kučera <franta-hg@frantovo.cz>
parents: 18
diff changeset
     2
	xmlns="https://trac.frantovo.cz/xml-web-generator/wiki/xmlns/strana"
0d2729ed16ed zkouška interního odkazu
František Kučera <franta-hg@frantovo.cz>
parents: 18
diff changeset
     3
	xmlns:m="https://trac.frantovo.cz/xml-web-generator/wiki/xmlns/makro">
0d2729ed16ed zkouška interního odkazu
František Kučera <franta-hg@frantovo.cz>
parents: 18
diff changeset
     4
	
317
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
     5
	<nadpis>Release v0.17</nadpis>
294
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
     6
	<perex>new public release of Relational pipes</perex>
317
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
     7
	<m:release>v0.17</m:release>
4
1bb39595a51c genrování hlavní nabídky #1
František Kučera <franta-hg@frantovo.cz>
parents: 2
diff changeset
     8
2
ab9099ff88fa vkládání zápatí, jmenné prostory, saxon
František Kučera <franta-hg@frantovo.cz>
parents: 1
diff changeset
     9
	<text xmlns="http://www.w3.org/1999/xhtml">
ab9099ff88fa vkládání zápatí, jmenné prostory, saxon
František Kučera <franta-hg@frantovo.cz>
parents: 1
diff changeset
    10
		<p>
256
822ffd23d679 Release v0.11
František Kučera <franta-hg@frantovo.cz>
parents: 250
diff changeset
    11
			We are pleased to introduce you the new development version of <m:name/>.
317
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    12
			This release improves and standardizes the CLI interface of several tools, brings a new output module + several smaller improvements.
241
f71d300205b7 Release v0.9
František Kučera <franta-hg@frantovo.cz>
parents: 219
diff changeset
    13
		</p>
f71d300205b7 Release v0.9
František Kučera <franta-hg@frantovo.cz>
parents: 219
diff changeset
    14
		
319
2a5f26e69a76 Release v0.17.1 – streamlet date example, big numbers fix, GUI charts fix
František Kučera <franta-hg@frantovo.cz>
parents: 317
diff changeset
    15
		<p>
2a5f26e69a76 Release v0.17.1 – streamlet date example, big numbers fix, GUI charts fix
František Kučera <franta-hg@frantovo.cz>
parents: 317
diff changeset
    16
			Note: there is also <m:a href="release-v0.17.1">v0.17.1</m:a> (the only difference are two fixes in <code>relpipe-out-gui</code>).
2a5f26e69a76 Release v0.17.1 – streamlet date example, big numbers fix, GUI charts fix
František Kučera <franta-hg@frantovo.cz>
parents: 317
diff changeset
    17
		</p>
2a5f26e69a76 Release v0.17.1 – streamlet date example, big numbers fix, GUI charts fix
František Kučera <franta-hg@frantovo.cz>
parents: 317
diff changeset
    18
		
241
f71d300205b7 Release v0.9
František Kučera <franta-hg@frantovo.cz>
parents: 219
diff changeset
    19
		<ul>
f71d300205b7 Release v0.9
František Kučera <franta-hg@frantovo.cz>
parents: 219
diff changeset
    20
			<li>
317
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    21
				<strong>The <code>relpipe-in-cli</code> module has changed CLI interface</strong>: see details below
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    22
			</li>
294
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
    23
			<li>
317
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    24
				<strong>The <code>relpipe-in-csv</code> module has changed CLI interface</strong>: see details below
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    25
			</li>
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    26
			<li>
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    27
				<strong>The <code>relpipe-out-csv</code> module has new CLI interface</strong>: see details below
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    28
			</li>
250
d16336d1c61f Release v0.10
František Kučera <franta-hg@frantovo.cz>
parents: 241
diff changeset
    29
			<li>
317
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    30
				<strong>The <code>relpipe-out-tabular</code> module has new CLI interface</strong>: see details below
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    31
			</li>
264
d39cfc926f95 XMLTable, SQL, v0.13
František Kučera <franta-hg@frantovo.cz>
parents: 258
diff changeset
    32
			<li>
317
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    33
				<strong>The <code>relpipe-tr-guile</code> was renamed to <code>relpipe-tr-scheme</code></strong>: see details below
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    34
			</li>
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    35
			<li>
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    36
				<strong>New tool <code>relpipe-out-jack</code> for generating MIDI through JACK</strong>: see details below
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    37
			</li>
241
f71d300205b7 Release v0.9
František Kučera <franta-hg@frantovo.cz>
parents: 219
diff changeset
    38
		</ul>
256
822ffd23d679 Release v0.11
František Kučera <franta-hg@frantovo.cz>
parents: 250
diff changeset
    39
		
241
f71d300205b7 Release v0.9
František Kučera <franta-hg@frantovo.cz>
parents: 219
diff changeset
    40
		<p>
256
822ffd23d679 Release v0.11
František Kučera <franta-hg@frantovo.cz>
parents: 250
diff changeset
    41
			See the <m:a href="examples">examples</m:a> and <m:a href="screenshots">screenshots</m:a> pages for details.
151
5697a01db388 roadmap
František Kučera <franta-hg@frantovo.cz>
parents: 147
diff changeset
    42
		</p>
256
822ffd23d679 Release v0.11
František Kučera <franta-hg@frantovo.cz>
parents: 250
diff changeset
    43
		
822ffd23d679 Release v0.11
František Kučera <franta-hg@frantovo.cz>
parents: 250
diff changeset
    44
		<p>
299
dd7aeff5ef0c fix typo: relasease → release
František Kučera <franta-hg@frantovo.cz>
parents: 297
diff changeset
    45
			Please note that this is still a development release and thus the API (libraries, CLI arguments, formats) might and will change.
256
822ffd23d679 Release v0.11
František Kučera <franta-hg@frantovo.cz>
parents: 250
diff changeset
    46
			Any suggestions, ideas and bug reports are welcome in our <m:a href="contact">mailing list</m:a>.
822ffd23d679 Release v0.11
František Kučera <franta-hg@frantovo.cz>
parents: 250
diff changeset
    47
		</p>
151
5697a01db388 roadmap
František Kučera <franta-hg@frantovo.cz>
parents: 147
diff changeset
    48
		
317
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    49
		<h2>New CLI interfaces</h2>
294
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
    50
		
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
    51
		<p>
317
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    52
			Several earlier tools have non-standard CLI interface and does not conform with <m:a href="principles">principle</m:a> „Use --long-options“.
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    53
			Posistional parameters might be shorter but they are also cryptic and less flexible.
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    54
			In this release the <code>relpipe-in-cli</code>, <code>relpipe-in-csv</code> tools dropped their old CLI interface
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    55
			and got a new one based on named parameters and long options.
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    56
			The <code>relpipe-out-csv</code> and <code>relpipe-out-tabular</code> had no parameters in previous versions and now have standard CLI interface.
294
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
    57
		</p>
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
    58
		
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
    59
		<p>
317
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    60
			In <code>relpipe-out-tabular</code> we can now optionally omit several parts:
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    61
			<code>--write-record-count false</code>,
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    62
			<code>--write-types false</code>,
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    63
			<code>--write-relation-name false</code>
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    64
			and thus simplify the output if we do not need given information.
294
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
    65
		</p>
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
    66
		
317
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    67
		<pre><![CDATA[ ╭───────┬────────╮
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    68
 │ first │ second │
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    69
 ├───────┼────────┤
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    70
 │     1 │ abc    │
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    71
 │     2 │ def    │
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    72
 ╰───────┴────────╯]]></pre>
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    73
 
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    74
		<p>
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    75
			These options may be set globally or for particular relation using the <code>--relation</code> option with pattern parameter.
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    76
			Thus we may e.g. print some relations with data types and some without them.
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    77
		</p>
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    78
297
192b0059a6c4 Release v0.16 – ODBC in SQL + JACK MIDI
František Kučera <franta-hg@frantovo.cz>
parents: 294
diff changeset
    79
		
294
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
    80
		<p>
317
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    81
			Remaining tools that will be transformed in the same way: <code>relpipe-tr-grep</code>, <code>relpipe-tr-cut</code>, <code>relpipe-tr-sed</code>
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    82
			and will get standard CLI interface.
294
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
    83
		</p>
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
    84
		
317
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    85
		<h2>JACK (MIDI) output module</h2>
294
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
    86
		
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
    87
		<p>
297
192b0059a6c4 Release v0.16 – ODBC in SQL + JACK MIDI
František Kučera <franta-hg@frantovo.cz>
parents: 294
diff changeset
    88
			A powerful audio system called <a href="https://jackaudio.org/">JACK</a> allows us to
192b0059a6c4 Release v0.16 – ODBC in SQL + JACK MIDI
František Kučera <franta-hg@frantovo.cz>
parents: 294
diff changeset
    89
			build pipelines consisting of audio interfaces, players, recorders, filters and effects…
192b0059a6c4 Release v0.16 – ODBC in SQL + JACK MIDI
František Kučera <franta-hg@frantovo.cz>
parents: 294
diff changeset
    90
			and route sound streams (both PCM and MIDI) through them.
192b0059a6c4 Release v0.16 – ODBC in SQL + JACK MIDI
František Kučera <franta-hg@frantovo.cz>
parents: 294
diff changeset
    91
			MIDI messages can come from keyboards or other hardware MIDI controllers or from MIDI players and other software.
317
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    92
		</p>
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    93
		<p>
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    94
			In the <m:a href="release-v0.16">v0.16</m:a> release, the <code>relpipe-in-jack</code> was introduced.
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    95
			This tools allowed capturing the MIDI events from JACK and sending them to the relational pipeline.
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    96
			Now, in v0.17, we introduce the counterpart tool <code>relpipe-out-jack</code> that reads relational data
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
    97
			and sends SysEx messages, MIDI notes and other events to the JACK pipeline.
297
192b0059a6c4 Release v0.16 – ODBC in SQL + JACK MIDI
František Kučera <franta-hg@frantovo.cz>
parents: 294
diff changeset
    98
		</p>
192b0059a6c4 Release v0.16 – ODBC in SQL + JACK MIDI
František Kučera <franta-hg@frantovo.cz>
parents: 294
diff changeset
    99
		
317
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   100
		<m:img src="img/jack-connections-2.png"/>
297
192b0059a6c4 Release v0.16 – ODBC in SQL + JACK MIDI
František Kučera <franta-hg@frantovo.cz>
parents: 294
diff changeset
   101
		
192b0059a6c4 Release v0.16 – ODBC in SQL + JACK MIDI
František Kučera <franta-hg@frantovo.cz>
parents: 294
diff changeset
   102
		<p>
317
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   103
			We can join the JACK graph with <code>relpipe-out-jack</code> command.
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   104
			It does not produce anything on STDOUT, it sends MIDI events to JACK instead, so no other output data are needed.
297
192b0059a6c4 Release v0.16 – ODBC in SQL + JACK MIDI
František Kučera <franta-hg@frantovo.cz>
parents: 294
diff changeset
   105
		</p>
192b0059a6c4 Release v0.16 – ODBC in SQL + JACK MIDI
František Kučera <franta-hg@frantovo.cz>
parents: 294
diff changeset
   106
		
192b0059a6c4 Release v0.16 – ODBC in SQL + JACK MIDI
František Kučera <franta-hg@frantovo.cz>
parents: 294
diff changeset
   107
		<p>
317
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   108
			Besides capturing and playing the MIDI, we can use the <code>relpipe-in-jack</code> and <code>relpipe-out-jack</code>
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   109
			to tak a snapshot of the JACK graph (connections between ports) and recreate it later.
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   110
			Or establish any new connections or break existing ones.
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   111
			Either through CLI commands of <code>relpipe-in-jack</code> or through relational data (list of connection and disconnection commands)
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   112
			sent to <code>relpipe-out-jack</code>.
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   113
		</p>
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   114
		
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   115
		<p>
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   116
			Both commands have also the <code>--required-connections</code> and <code>--connect-to</code> parameters,
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   117
			so they can react on reaching particular connection count or automatically connect their port to another one specified on the CLI.
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   118
			The bash-completion suggests available port names.
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   119
		</p>
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   120
		
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   121
		<p>
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   122
			More details in the examples:
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   123
			<m:a href="examples-jack-ports">Working with JACK ports</m:a>
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   124
			and <m:a href="examples-jack-midi-generating-1">Generating and sending MIDI messages</m:a>.
294
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   125
		</p>
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   126
		
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   127
		<h2>Feature overview</h2>
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   128
		
151
5697a01db388 roadmap
František Kučera <franta-hg@frantovo.cz>
parents: 147
diff changeset
   129
		<h3>Data types</h3>
5697a01db388 roadmap
František Kučera <franta-hg@frantovo.cz>
parents: 147
diff changeset
   130
		<ul>
241
f71d300205b7 Release v0.9
František Kučera <franta-hg@frantovo.cz>
parents: 219
diff changeset
   131
			<li m:since="v0.8">boolean</li>
294
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   132
			<li m:since="v0.15">variable-length signed integer (SLEB128)</li>
241
f71d300205b7 Release v0.9
František Kučera <franta-hg@frantovo.cz>
parents: 219
diff changeset
   133
			<li m:since="v0.8">string in UTF-8</li>
151
5697a01db388 roadmap
František Kučera <franta-hg@frantovo.cz>
parents: 147
diff changeset
   134
		</ul>
5697a01db388 roadmap
František Kučera <franta-hg@frantovo.cz>
parents: 147
diff changeset
   135
		<h3>Inputs</h3>
5697a01db388 roadmap
František Kučera <franta-hg@frantovo.cz>
parents: 147
diff changeset
   136
		<ul>
256
822ffd23d679 Release v0.11
František Kučera <franta-hg@frantovo.cz>
parents: 250
diff changeset
   137
			<li m:since="v0.11">Recfile</li>
241
f71d300205b7 Release v0.9
František Kučera <franta-hg@frantovo.cz>
parents: 219
diff changeset
   138
			<li m:since="v0.9">XML</li>
264
d39cfc926f95 XMLTable, SQL, v0.13
František Kučera <franta-hg@frantovo.cz>
parents: 258
diff changeset
   139
			<li m:since="v0.13">XMLTable</li>
241
f71d300205b7 Release v0.9
František Kučera <franta-hg@frantovo.cz>
parents: 219
diff changeset
   140
			<li m:since="v0.9">CSV</li>
f71d300205b7 Release v0.9
František Kučera <franta-hg@frantovo.cz>
parents: 219
diff changeset
   141
			<li m:since="v0.9">file system</li>
f71d300205b7 Release v0.9
František Kučera <franta-hg@frantovo.cz>
parents: 219
diff changeset
   142
			<li m:since="v0.8">CLI</li>
f71d300205b7 Release v0.9
František Kučera <franta-hg@frantovo.cz>
parents: 219
diff changeset
   143
			<li m:since="v0.8">fstab</li>
282
ec02133045a3 Release v0.14 – SQL, AWK, Bash completion, GPLv3
František Kučera <franta-hg@frantovo.cz>
parents: 276
diff changeset
   144
			<li m:since="v0.14">SQL script</li>
297
192b0059a6c4 Release v0.16 – ODBC in SQL + JACK MIDI
František Kučera <franta-hg@frantovo.cz>
parents: 294
diff changeset
   145
			<li m:since="v0.16">JACK</li>
151
5697a01db388 roadmap
František Kučera <franta-hg@frantovo.cz>
parents: 147
diff changeset
   146
		</ul>
5697a01db388 roadmap
František Kučera <franta-hg@frantovo.cz>
parents: 147
diff changeset
   147
		<h3>Transformations</h3>
5697a01db388 roadmap
František Kučera <franta-hg@frantovo.cz>
parents: 147
diff changeset
   148
		<ul>
264
d39cfc926f95 XMLTable, SQL, v0.13
František Kučera <franta-hg@frantovo.cz>
parents: 258
diff changeset
   149
			<li m:since="v0.13">sql: filtering and transformations using the SQL language</li>
258
2868d772c27e Release v0.12 – AWK
František Kučera <franta-hg@frantovo.cz>
parents: 256
diff changeset
   150
			<li m:since="v0.12">awk: filtering and transformations using the classic AWK tool and language</li>
317
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   151
			<li m:since="v0.10">scheme: filtering and transformations defined in the Scheme language using GNU Guile</li>
241
f71d300205b7 Release v0.9
František Kučera <franta-hg@frantovo.cz>
parents: 219
diff changeset
   152
			<li m:since="v0.8">grep: regular expression filter, removes unwanted records from the relation</li>
f71d300205b7 Release v0.9
František Kučera <franta-hg@frantovo.cz>
parents: 219
diff changeset
   153
			<li m:since="v0.8">cut: regular expression attribute cutter (removes or duplicates attributes and can also DROP whole relation)</li>
f71d300205b7 Release v0.9
František Kučera <franta-hg@frantovo.cz>
parents: 219
diff changeset
   154
			<li m:since="v0.8">sed: regular expression replacer</li>
294
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   155
			<li m:since="v0.8">validator: just a pass-through filter that crashes on invalid data</li>
241
f71d300205b7 Release v0.9
František Kučera <franta-hg@frantovo.cz>
parents: 219
diff changeset
   156
			<li m:since="v0.8">python: highly experimental</li>
151
5697a01db388 roadmap
František Kučera <franta-hg@frantovo.cz>
parents: 147
diff changeset
   157
		</ul>
294
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   158
		<h3>Streamlets</h3>
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   159
		<ul>
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   160
			<li m:since="v0.15">xpath (example, unstable)</li>
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   161
			<li m:since="v0.15">hash (example, unstable)</li>
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   162
			<li m:since="v0.15">jar_info (example, unstable)</li>
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   163
			<li m:since="v0.15">mime_type (example, unstable)</li>
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   164
			<li m:since="v0.15">exiftool (example, unstable)</li>
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   165
			<li m:since="v0.15">pid (example, unstable)</li>
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   166
			<li m:since="v0.15">cloc (example, unstable)</li>
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   167
			<li m:since="v0.15">exiv2 (example, unstable)</li>
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   168
			<li m:since="v0.15">inode (example, unstable)</li>
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   169
			<li m:since="v0.15">lines_count (example, unstable)</li>
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   170
			<li m:since="v0.15">pdftotext (example, unstable)</li>
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   171
			<li m:since="v0.15">pdfinfo (example, unstable)</li>
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   172
			<li m:since="v0.15">tesseract (example, unstable)</li>
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   173
		</ul>
151
5697a01db388 roadmap
František Kučera <franta-hg@frantovo.cz>
parents: 147
diff changeset
   174
		<h3>Outputs</h3>
5697a01db388 roadmap
František Kučera <franta-hg@frantovo.cz>
parents: 147
diff changeset
   175
		<ul>
256
822ffd23d679 Release v0.11
František Kučera <franta-hg@frantovo.cz>
parents: 250
diff changeset
   176
			<li m:since="v0.11">ASN.1 BER</li>
822ffd23d679 Release v0.11
František Kučera <franta-hg@frantovo.cz>
parents: 250
diff changeset
   177
			<li m:since="v0.11">Recfile</li>
241
f71d300205b7 Release v0.9
František Kučera <franta-hg@frantovo.cz>
parents: 219
diff changeset
   178
			<li m:since="v0.9">CSV</li>
f71d300205b7 Release v0.9
František Kučera <franta-hg@frantovo.cz>
parents: 219
diff changeset
   179
			<li m:since="v0.8">tabular</li>
f71d300205b7 Release v0.9
František Kučera <franta-hg@frantovo.cz>
parents: 219
diff changeset
   180
			<li m:since="v0.8">XML</li>
f71d300205b7 Release v0.9
František Kučera <franta-hg@frantovo.cz>
parents: 219
diff changeset
   181
			<li m:since="v0.8">nullbyte</li>
f71d300205b7 Release v0.9
František Kučera <franta-hg@frantovo.cz>
parents: 219
diff changeset
   182
			<li m:since="v0.8">GUI in Qt</li>
f71d300205b7 Release v0.9
František Kučera <franta-hg@frantovo.cz>
parents: 219
diff changeset
   183
			<li m:since="v0.8">ODS (LibreOffice)</li>
317
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   184
			<li m:since="v0.17">JACK</li>
151
5697a01db388 roadmap
František Kučera <franta-hg@frantovo.cz>
parents: 147
diff changeset
   185
		</ul>
5697a01db388 roadmap
František Kučera <franta-hg@frantovo.cz>
parents: 147
diff changeset
   186
		
294
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   187
		<h2>New examples</h2>
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   188
		<ul>
317
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   189
			<li><m:a href="examples-jack-ports">Working with JACK ports</m:a></li>
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   190
			<li><m:a href="examples-jack-midi-generating-1">Generating and sending MIDI messages</m:a></li>
294
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   191
		</ul>
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   192
		
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   193
		<h2>Backward incompatible changes</h2>
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   194
		
151
5697a01db388 roadmap
František Kučera <franta-hg@frantovo.cz>
parents: 147
diff changeset
   195
		<p>
317
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   196
			The <code>relpipe-tr-guile</code> has been renamed to <code>relpipe-tr-scheme</code>, so it is necessary to modify existing scripts.
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   197
			However the CLI interface has not been changed, thus it can be simply updated e.g. by:
297
192b0059a6c4 Release v0.16 – ODBC in SQL + JACK MIDI
František Kučera <franta-hg@frantovo.cz>
parents: 294
diff changeset
   198
		</p>
317
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   199
		<m:pre jazyk="bash">sed s/relpipe-tr-guile/relpipe-tr-scheme/g -i script.sh</m:pre>
297
192b0059a6c4 Release v0.16 – ODBC in SQL + JACK MIDI
František Kučera <franta-hg@frantovo.cz>
parents: 294
diff changeset
   200
		<p>
317
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   201
			The reason behind this rename is that Scheme is a programming language and Guile is one of implementations of this language.
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   202
			And we prefer <a href="https://sane-software.globalcode.info/v_0/#a0f42ec9-5032-4f6d-a50a-4b7bddde77f0">depending on interfaces</a> rather than on particular implementations.
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   203
			Similar situation is <code>relpipe-tr-sql</code>: this module is also named after the language (SQL), not after the default implementation (SQLite)
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   204
			and this module can use <m:a href="examples-tr-sql-odbc">any SQL engine</m:a>.
297
192b0059a6c4 Release v0.16 – ODBC in SQL + JACK MIDI
František Kučera <franta-hg@frantovo.cz>
parents: 294
diff changeset
   205
		</p>
192b0059a6c4 Release v0.16 – ODBC in SQL + JACK MIDI
František Kučera <franta-hg@frantovo.cz>
parents: 294
diff changeset
   206
		
192b0059a6c4 Release v0.16 – ODBC in SQL + JACK MIDI
František Kučera <franta-hg@frantovo.cz>
parents: 294
diff changeset
   207
		<p>
317
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   208
			The CLI interface of the <code>relpipe-in-cli</code> tool has been standardized and made consistent with other tools.
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   209
			Now, it uses named parameters instead of cryptic positional ones.
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   210
			The format of the STDIN stream remains unchanged (values separated by <code>\0</code> byte).
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   211
		</p>
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   212
		
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   213
		<m:pre jazyk="bash"><![CDATA[# Old syntax before v0.17:
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   214
relpipe-in-cli generate "relation_from_cli" 3 \
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   215
	"a" "integer" \
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   216
	"b" "string" \
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   217
	"c" "boolean" \
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   218
	"1" "Hello" "true" \
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   219
	"2" "World!" "false"
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   220
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   221
# New syntax:
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   222
relpipe-in-cli \
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   223
	--relation "relation_from_cli" \
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   224
		--attribute "a" integer \
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   225
		--attribute "b" string \
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   226
		--attribute "c" boolean \
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   227
		--record "1" "Hello" "true" \
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   228
		--record "2" "World!" "false"
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   229
]]></m:pre>
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   230
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   231
		<p>
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   232
			We can repeat these parameters and generate several relations (that was not possibel in the older version).
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   233
			One relation may be filled with values from STDIN: <code>--records-on-stdin true</code> (replaces the old <code>relpipe-in-cli generate-from-stdin</code> syntax).
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   234
			And the last relation may be filled with values from remaining CLI arguments: <code>--records "1" "Hello" "true" "2" "World!" "false"</code>.
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   235
			The demo (<code>relpipe-in-cli demo</code>) has been removed (sample data can be easily generated by setting the CLI arguments).
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   236
		</p>
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   237
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   238
		<p>
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   239
			The CLI interface of the <code>relpipe-in-csv</code> tool has also been standardized and made consistent with other tools.
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   240
			If we have attribute names on the first line of the CSV file (which is quite common), the usage is same as in previous versions:
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   241
		</p>
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   242
		
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   243
		<m:pre jazyk="bash"><![CDATA[cat file.csv | relpipe-in-csv]]></m:pre>
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   244
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   245
		<p>If we have only data in the CSV file (no headers) and thus want to specify them on CLI, the syntax is different:</p>
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   246
		
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   247
		<m:pre jazyk="bash"><![CDATA[# Old syntax before v0.17:
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   248
cat file.csv | relpipe-in-csv "my_relation" "a" integer "b" boolean
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   249
			
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   250
# New syntax:
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   251
cat file.csv | relpipe-in-csv \
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   252
	--relation "my_relation" \
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   253
		--attribute "a" integer \
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   254
		--attribute "b" boolean
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   255
]]></m:pre>
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   256
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   257
		<p>Bash-completion scripts for all tools are provided.</p>
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   258
		
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   259
		<p>
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   260
			Future versions should allow optionally storing the attribute data types in the CSV header and parsing them back (together with the attribute names).
294
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   261
		</p>
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   262
		
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   263
		<h2>Installation</h2>
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   264
		
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   265
		<p>
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   266
			Instalation was tested on Debian GNU/Linux 10.2.
219
a94eb371f77e Release v0.8
František Kučera <franta-hg@frantovo.cz>
parents: 218
diff changeset
   267
			The process should be similar on other distributions.
a94eb371f77e Release v0.8
František Kučera <franta-hg@frantovo.cz>
parents: 218
diff changeset
   268
		</p>
151
5697a01db388 roadmap
František Kučera <franta-hg@frantovo.cz>
parents: 147
diff changeset
   269
		
317
fce3d6290c40 Release v0.16 – JACK MIDI output, ports + rename Guile to Scheme + improve CLI interfaces
František Kučera <franta-hg@frantovo.cz>
parents: 299
diff changeset
   270
		<m:pre src="examples/release-v0.17.sh" jazyk="bash" odkaz="ano"/>
151
5697a01db388 roadmap
František Kučera <franta-hg@frantovo.cz>
parents: 147
diff changeset
   271
		
219
a94eb371f77e Release v0.8
František Kučera <franta-hg@frantovo.cz>
parents: 218
diff changeset
   272
		<p>
a94eb371f77e Release v0.8
František Kučera <franta-hg@frantovo.cz>
parents: 218
diff changeset
   273
			<m:name/> are modular thus you can download and install only parts you need (the libraries are needed always).
a94eb371f77e Release v0.8
František Kučera <franta-hg@frantovo.cz>
parents: 218
diff changeset
   274
			Tools <code>out-gui.qt</code> and <code>tr-python</code> require additional libraries and are not built by default.
a94eb371f77e Release v0.8
František Kučera <franta-hg@frantovo.cz>
parents: 218
diff changeset
   275
		</p>
151
5697a01db388 roadmap
František Kučera <franta-hg@frantovo.cz>
parents: 147
diff changeset
   276
		
87
25dec6931f18 Lepší odsazení, tabulátory.
František Kučera <franta-hg@frantovo.cz>
parents: 23
diff changeset
   277
	</text>
4
1bb39595a51c genrování hlavní nabídky #1
František Kučera <franta-hg@frantovo.cz>
parents: 2
diff changeset
   278
294
abbc9bcfbcc4 Release v0.15 – streamlets, parallel processing
František Kučera <franta-hg@frantovo.cz>
parents: 282
diff changeset
   279
</stránka>