[release] Prepare new 0.19.1 release.

Author: cipriancraciun

documentation/manual/z-run.1.html

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "Z\-RUN" "1" "2022-03-22" "volution.ro" "z-run"
+.TH "Z\-RUN" "1" "2022-07-26" "volution.ro" "z-run"
 .
 .SH "NAME"
 \fBz\-run\fR \- lightweight scripts library tool

documentation/manual/z-run.1.man

@@ -402,4 +402,4 @@ EXAMPLES
 
 
 
-volution.ro                       2022-03-22                          Z-RUN(1)
+volution.ro                       2022-07-26                          Z-RUN(1)

documentation/manual/z-run.1.txt

@@ -222,7 +222,7 @@
 </code></pre><ul><li>environment variables can be defined to string values:</li></ul><pre><code>&amp;&amp;== env SOME_ENV some-value
 </code></pre><ul><li>environment variables can be defined to absolute paths:</li></ul><pre><code>&amp;&amp;== env SOME_PATH ./relative-path
 </code></pre><ul><li>the <code>$PATH</code> environment variable can be appended with absolute paths:</li></ul><pre><code>&amp;&amp;== path ./bin
-</code></pre><ul><li>environment variables, similar to <code>$PATH</code>, can be appended with absolute paths:</li></ul><pre><code>&amp;&amp;== env-path-append ./bin
+</code></pre><ul><li>environment variables, similar to <code>$PATH</code>, can be appended with absolute paths:</li></ul><pre><code>&amp;&amp;== env-path-append SOME_ENV_LIKE_PATH ./bin
 </code></pre><ul><li>environment variables can be removed:</li></ul><pre><code>&amp;&amp;== env-exclude SOME_ENV_1 SOME_ENV_2
 </code></pre><ul><li>environment variables can be provided with defaults:</li></ul><pre><code>&amp;&amp;== env-fallback SOME_ENV default-value
 </code></pre><ul><li>other library source files can be included:</li></ul><pre><code>&amp;&amp; _/file-relative-to-the-current-source-file-parent
@@ -247,20 +247,20 @@
 </code></pre><ul><li>select a scriptlet from the menu,
 and print its body:</li></ul><pre><code>z-run select-body
 </code></pre><p><strong>TBD:</strong></p><ul><li>compiling libraries and using them;</li><li>executing remote scriptlets over SSH;</li><li>using a library as a standalone tool with <code>z-run --exec</code>;</li><li>executing standalone scriptlets with <code>z-run --scriptlet</code>;</li><li>executing standalone scriptlets with <code>z-run --scriptlet-exec</code>;</li><li>executing standalone templates with <code>z-run --template</code>;</li><li><code>z-run --input</code>, <code>z-run --select</code>, and <code>z-run --fzf</code>;</li><li><code>z-run --shell</code>;</li><li><code>z-run --export=shell-functions</code>;</li><li><code>z-run --version</code>;</li><li><code>z-run --help</code>;</li><li><code>z-run --manual</code>;</li><li><code>z-run --manual-man</code>;</li><li><code>z-run --manual-html</code>;</li><li><code>z-run --readme</code>;</li><li><code>z-run --readme-html</code>;</li><li><code>z-run --sbom</code>;</li><li><code>z-run --sbom-html</code>;</li><li><code>z-run --sbom-json</code>;</li><li><code>z-run --sources-md5</code>;</li><li><code>z-run --sources-cpio | gunzip | cpio -i -t</code>;</li></ul><hr><h2>Installation</h2><h3>Download prebuilt executables</h3><p>One should see the <a href=https://github.com/volution/z-run/releases>releases page on GitHub</a>,
-where pre-built executables (only Intel 64bit architectures) are available for:</p><ul><li>Linux (the main development and testing environment) --<br><a href=https://github.com/volution/z-run/releases/download/v0.18.1/z-run--linux--v0.18.1>https://github.com/volution/z-run/releases/download/v0.18.1/z-run--linux--v0.18.1</a></li><li>OSX (only Intel CPU's) (the second targeted environment) --<br><a href=https://github.com/volution/z-run/releases/download/v0.18.1/z-run--darwin--v0.18.1>https://github.com/volution/z-run/releases/download/v0.18.1/z-run--darwin--v0.18.1</a></li><li>OpenBSD (seldom tested) --<br><a href=https://github.com/volution/z-run/releases/download/v0.18.1/z-run--openbsd--v0.18.1>https://github.com/volution/z-run/releases/download/v0.18.1/z-run--openbsd--v0.18.1</a></li><li>FreeBSD (seldom tested) --<br><a href=https://github.com/volution/z-run/releases/download/v0.18.1/z-run--freebsd--v0.18.1>https://github.com/volution/z-run/releases/download/v0.18.1/z-run--freebsd--v0.18.1</a></li></ul><p>Also, each of these files are signed with my PGP key <code>5A974037A6FD8839</code>, thus do check the signature.</p><p>For example:</p><ul><li>import my PGP key:</li></ul><pre><code>curl -s https://github.com/cipriancraciun.gpg | gpg2 --import
+where pre-built executables (only Intel 64bit architectures) are available for:</p><ul><li>Linux (the main development and testing environment) --<br><a href=https://github.com/volution/z-run/releases/download/v0.19.1/z-run--linux--v0.19.1>https://github.com/volution/z-run/releases/download/v0.19.1/z-run--linux--v0.19.1</a></li><li>OSX (only Intel CPU's) (the second targeted environment) --<br><a href=https://github.com/volution/z-run/releases/download/v0.19.1/z-run--darwin--v0.19.1>https://github.com/volution/z-run/releases/download/v0.19.1/z-run--darwin--v0.19.1</a></li><li>OpenBSD (seldom tested) --<br><a href=https://github.com/volution/z-run/releases/download/v0.19.1/z-run--openbsd--v0.19.1>https://github.com/volution/z-run/releases/download/v0.19.1/z-run--openbsd--v0.19.1</a></li><li>FreeBSD (seldom tested) --<br><a href=https://github.com/volution/z-run/releases/download/v0.19.1/z-run--freebsd--v0.19.1>https://github.com/volution/z-run/releases/download/v0.19.1/z-run--freebsd--v0.19.1</a></li></ul><p>Also, each of these files are signed with my PGP key <code>5A974037A6FD8839</code>, thus do check the signature.</p><p>For example:</p><ul><li>import my PGP key:</li></ul><pre><code>curl -s https://github.com/cipriancraciun.gpg | gpg2 --import
 </code></pre><pre><code>gpg: key 5A974037A6FD8839: public key &quot;Ciprian Dorin Craciun &lt;[email protected]&gt;&quot; imported
 gpg: Total number processed: 1
 gpg:               imported: 1
 </code></pre><ul><li>download the executable and signature (replace the <code>linux</code> token with <code>darwin</code> (for OSX), <code>freebsd</code> or <code>openbsd</code>):</li></ul><pre><code>curl \
         -s -S -f -L \
         -o /tmp/z-run \
-        https://github.com/volution/z-run/releases/download/v0.18.1/z-run--linux--v0.18.1 \
+        https://github.com/volution/z-run/releases/download/v0.19.1/z-run--linux--v0.19.1 \
 #
 
 curl \
         -s -S -f -L \
         -o /tmp/z-run.asc \
-        https://github.com/volution/z-run/releases/download/v0.18.1/z-run--linux--v0.18.1.asc \
+        https://github.com/volution/z-run/releases/download/v0.19.1/z-run--linux--v0.19.1.asc \
 #
 </code></pre><ul><li>verify the executable:</li></ul><pre><code>gpg2 --verify /tmp/z-run.asc /tmp/z-run
 </code></pre><ul><li><strong>check that the key is <code>58FC2194FCC2478399CB220C5A974037A6FD8839</code></strong>:</li></ul><pre><code>gpg: assuming signed data in '/tmp/z-run'
@@ -275,16 +275,16 @@
 </code></pre><ul><li>copy the executable on the <code>$PATH</code>:</li></ul><pre><code>sudo cp /tmp/z-run /usr/local/bin/z-run
 </code></pre><ul><li>check that it works:</li></ul><pre><code>z-run --version
 </code></pre><pre><code>* tool          : z-run
-* version       : 0.19.0
+* version       : 0.19.1
 * executable    : /usr/local/bin/z-run
-* build target  : release, linux-amd64, go1.17.6, gc
-* build number  : 12170, 2022-01-19-23-30-43
+* build target  : release, linux-amd64, go1.18.3, gc
+* build number  : 12286, 2022-07-26-10-01-10
 * code &amp; issues : https://github.com/volution/z-run
-* sources git   : a6e6ce1dbd63eb871ad0280d6dbafdbc9e7960d9
-* sources hash  : d7ba8be84e85329ac187984750ecd242
+* sources git   : 4420e1f27c2480595ac98e409727c6810498710b
+* sources hash  : daf4d73647bc52c3efe3f60f7711439a
 * uname node    : some-workstation
-* uname system  : Linux, 5.15.6-1-default, x86_64
-* uname hash    : 7c8643e588e6fbb4063d2643de27c39b
+* uname system  : Linux, 5.18.4-1-default, x86_64
+* uname hash    : 636fe534b72441e2ccb478f9bd56d653
 </code></pre><h3>Build from sources</h3><p>Go is a prerequisite;
 one can install it from any Linux or BSD package manager,
 or OSX's <code>brew</code>,
@@ -423,7 +423,7 @@
 to any platform it supports.</p><p>Because Rust is less portable than Go;
 for example, Rust doesn't consider OpenBSD as a "tier-1" platform.</p><h3>What other open-source code does it depend on?</h3><ul><li><a href=https://github.com/junegunn/fzf>fzf</a>
 (via my custom <a href=https://github.com/cipriancraciun/fzf>fork</a>);</li><li><a href=https://github.com/colinmarc/cdb>cdb</a>
-(via my custom <a href=github.com/cipriancraciun/go-cdb-lib>fork</a>;</li><li><a href=github.com/jessevdk/go-flags>go-flags</a>;</li><li><a href=github.com/peterh/liner>liner</a>;</li><li>also see the <a href=./sources/go.mod>go.mod</a> file
+(via my custom <a href=github.com/cipriancraciun/go-cdb-lib>fork</a>);</li><li><a href=github.com/jessevdk/go-flags>go-flags</a>;</li><li><a href=github.com/peterh/liner>liner</a>;</li><li>also see the <a href=./sources/go.mod>go.mod</a> file
 for other minor dependencies;</li></ul><h3>Some related readings...</h3><ul><li><a href=https://slack.engineering/development-environments-at-slack/>Development Environments at Slack</a></li></ul><hr><h2>Notice (copyright and licensing)</h2><h3>Authors</h3><p>Ciprian Dorin Craciun:</p><ul><li><a href=mailto:[email protected]>[email protected]</a> or <a href=mailto:[email protected]>[email protected]</a></li><li><a href=https://volution.ro/ciprian>https://volution.ro/ciprian</a></li><li><a href=https://github.com/volution>https://github.com/volution</a></li><li><a href=https://github.com/cipriancraciun>https://github.com/cipriancraciun</a></li></ul><p>Please also see the <a href=./documentation/sbom/sbom.md>SBOM (Software Bill of Materials)</a>
 for links this project's dependencies and their authors.</p><h3>Notice -- short version</h3><p>The code is licensed under GPL 3 or later.</p><p>This is the same license as used by
 Linux, Git, MySQL/MariaDB, WordPress, F-Droid,

documentation/readme/readme.html

@@ -605,13 +605,13 @@ z-run select-body
 One should see the [releases page on GitHub](https://github.com/volution/z-run/releases),
 where pre-built executables (only Intel 64bit architectures) are available for:
 * Linux (the main development and testing environment) -- <br/>
-  <https://github.com/volution/z-run/releases/download/v0.18.1/z-run--linux--v0.18.1>
+  <https://github.com/volution/z-run/releases/download/v0.19.1/z-run--linux--v0.19.1>
 * OSX (only Intel CPU's) (the second targeted environment) -- <br/>
-  <https://github.com/volution/z-run/releases/download/v0.18.1/z-run--darwin--v0.18.1>
+  <https://github.com/volution/z-run/releases/download/v0.19.1/z-run--darwin--v0.19.1>
 * OpenBSD (seldom tested) -- <br/>
-  <https://github.com/volution/z-run/releases/download/v0.18.1/z-run--openbsd--v0.18.1>
+  <https://github.com/volution/z-run/releases/download/v0.19.1/z-run--openbsd--v0.19.1>
 * FreeBSD (seldom tested) -- <br/>
-  <https://github.com/volution/z-run/releases/download/v0.18.1/z-run--freebsd--v0.18.1>
+  <https://github.com/volution/z-run/releases/download/v0.19.1/z-run--freebsd--v0.19.1>
 
 Also, each of these files are signed with my PGP key `5A974037A6FD8839`, thus do check the signature.
 
@@ -633,13 +633,13 @@ gpg:               imported: 1
 curl \
         -s -S -f -L \
         -o /tmp/z-run \
-        https://github.com/volution/z-run/releases/download/v0.18.1/z-run--linux--v0.18.1 \
+        https://github.com/volution/z-run/releases/download/v0.19.1/z-run--linux--v0.19.1 \
 #
 
 curl \
         -s -S -f -L \
         -o /tmp/z-run.asc \
-        https://github.com/volution/z-run/releases/download/v0.18.1/z-run--linux--v0.18.1.asc \
+        https://github.com/volution/z-run/releases/download/v0.19.1/z-run--linux--v0.19.1.asc \
 #
 ~~~~
 
@@ -676,16 +676,16 @@ z-run --version
 ~~~~
 ~~~~
 * tool          : z-run
-* version       : 0.19.0
+* version       : 0.19.1
 * executable    : /usr/local/bin/z-run
-* build target  : release, linux-amd64, go1.17.6, gc
-* build number  : 12170, 2022-01-19-23-30-43
+* build target  : release, linux-amd64, go1.18.3, gc
+* build number  : 12286, 2022-07-26-10-01-10
 * code & issues : https://github.com/volution/z-run
-* sources git   : a6e6ce1dbd63eb871ad0280d6dbafdbc9e7960d9
-* sources hash  : d7ba8be84e85329ac187984750ecd242
+* sources git   : 4420e1f27c2480595ac98e409727c6810498710b
+* sources hash  : daf4d73647bc52c3efe3f60f7711439a
 * uname node    : some-workstation
-* uname system  : Linux, 5.15.6-1-default, x86_64
-* uname hash    : 7c8643e588e6fbb4063d2643de27c39b
+* uname system  : Linux, 5.18.4-1-default, x86_64
+* uname hash    : 636fe534b72441e2ccb478f9bd56d653
 ~~~~
 
 

documentation/readme/readme.md

@@ -375,7 +375,7 @@ some text that doesn't contain ##}}
   * environment variables, similar to $PATH, can be appended with absolute
     paths:
 
-&&== env-path-append ./bin
+&&== env-path-append SOME_ENV_LIKE_PATH ./bin
 
   * environment variables can be removed:
 
@@ -480,17 +480,17 @@ One should see the releases page on GitHub, where pre-built executables (only
 Intel 64bit architectures) are available for:
 
   * Linux (the main development and testing environment) --
-    https://github.com/volution/z-run/releases/download/v0.18.1/
-    z-run--linux--v0.18.1
+    https://github.com/volution/z-run/releases/download/v0.19.1/
+    z-run--linux--v0.19.1
   * OSX (only Intel CPU's) (the second targeted environment) --
-    https://github.com/volution/z-run/releases/download/v0.18.1/
-    z-run--darwin--v0.18.1
+    https://github.com/volution/z-run/releases/download/v0.19.1/
+    z-run--darwin--v0.19.1
   * OpenBSD (seldom tested) --
-    https://github.com/volution/z-run/releases/download/v0.18.1/
-    z-run--openbsd--v0.18.1
+    https://github.com/volution/z-run/releases/download/v0.19.1/
+    z-run--openbsd--v0.19.1
   * FreeBSD (seldom tested) --
-    https://github.com/volution/z-run/releases/download/v0.18.1/
-    z-run--freebsd--v0.18.1
+    https://github.com/volution/z-run/releases/download/v0.19.1/
+    z-run--freebsd--v0.19.1
 
 Also, each of these files are signed with my PGP key 5A974037A6FD8839, thus do
 check the signature.
@@ -511,13 +511,13 @@ gpg:               imported: 1
 curl \
         -s -S -f -L \
         -o /tmp/z-run \
-        https://github.com/volution/z-run/releases/download/v0.18.1/z-run--linux--v0.18.1 \
+        https://github.com/volution/z-run/releases/download/v0.19.1/z-run--linux--v0.19.1 \
 #
 
 curl \
         -s -S -f -L \
         -o /tmp/z-run.asc \
-        https://github.com/volution/z-run/releases/download/v0.18.1/z-run--linux--v0.18.1.asc \
+        https://github.com/volution/z-run/releases/download/v0.19.1/z-run--linux--v0.19.1.asc \
 #
 
   * verify the executable:
@@ -548,16 +548,16 @@ sudo cp /tmp/z-run /usr/local/bin/z-run
 z-run --version
 
 * tool          : z-run
-* version       : 0.19.0
+* version       : 0.19.1
 * executable    : /usr/local/bin/z-run
-* build target  : release, linux-amd64, go1.17.6, gc
-* build number  : 12170, 2022-01-19-23-30-43
+* build target  : release, linux-amd64, go1.18.3, gc
+* build number  : 12286, 2022-07-26-10-01-10
 * code & issues : https://github.com/volution/z-run
-* sources git   : a6e6ce1dbd63eb871ad0280d6dbafdbc9e7960d9
-* sources hash  : d7ba8be84e85329ac187984750ecd242
+* sources git   : 4420e1f27c2480595ac98e409727c6810498710b
+* sources hash  : daf4d73647bc52c3efe3f60f7711439a
 * uname node    : some-workstation
-* uname system  : Linux, 5.15.6-1-default, x86_64
-* uname hash    : 7c8643e588e6fbb4063d2643de27c39b
+* uname system  : Linux, 5.18.4-1-default, x86_64
+* uname hash    : 636fe534b72441e2ccb478f9bd56d653
 
 Build from sources
 
@@ -773,7 +773,7 @@ OpenBSD as a "tier-1" platform.
 What other open-source code does it depend on?
 
   * fzf (via my custom fork);
-  * cdb (via my custom fork;
+  * cdb (via my custom fork);
   * go-flags;
   * liner;
   * also see the go.mod file for other minor dependencies;

documentation/readme/readme.txt

@@ -1 +1 @@
-12284
+12287

sources/embedded/build/number.txt

@@ -1 +1 @@
-f35589a28d9076fa1bf39d2789475262
+07b27032559f57cc09a4ca3de5408456

sources/embedded/build/sources.cpio.gz

@@ -11,15 +11,15 @@ b7bd2ebef5fe1e6977b63c341c02fda1 *embedded/build.go
 e0529455b4b50e667909e37e7ac8d439 *embedded/documentation.go
 c3b76b61baa2fd78b28460c7fab83d59 *embedded/documentation/help--footer.txt
 0e9cb89d642e013ed3dd94ae045be082 *embedded/documentation/help--header.txt
-8fddf406a71dd905846f649ad3767c8c *embedded/documentation/readme.html
-616d826a1a4fc80a3698a73bbc4a7485 *embedded/documentation/readme.txt
+00f1631bd9bc634dece6c4440fe7a6a3 *embedded/documentation/readme.html
+388502f37a04a2a05c122d3478b99bbd *embedded/documentation/readme.txt
 e2ec2ca9b0e908ea5635a2c70938c3aa *embedded/documentation/sbom.html
 c35ec07dce11d78b720334c881a7c69c *embedded/documentation/sbom.json
 1d3c2ce3941de54437dc857c091a78f7 *embedded/documentation/sbom.txt
 35585845c8b1c58f8748791c618b9869 *embedded/documentation/z-run--help.txt
-89ca741ab7b430f62a56c68cd978023a *embedded/documentation/z-run--manual.html
-37ae32e8113f3208e63579f7421a91e1 *embedded/documentation/z-run--manual.man
-eb4b43ecc65546aa4f3909762bd34dbf *embedded/documentation/z-run--manual.txt
+23228e7d34722db85da20edc2bcf0784 *embedded/documentation/z-run--manual.html
+8ffa65b2e8bc6898f70f380285cfaab6 *embedded/documentation/z-run--manual.man
+ada4858ffaa2bdf21348829977c7d60d *embedded/documentation/z-run--manual.txt
 b1e1c36106351c75d7f9d05767aa0e1e *embedded/prologues.go
 bb2839ab009617e6ae7fd5b5bd16ccaf *embedded/prologues/go.go0
 67186e03764c63329fbbdeae8247c444 *embedded/prologues/python3.py0