more doc-neatens re windows and mlr -s

docs/src/miller-on-windows.md

@@ -55,3 +55,5 @@ One workaround is to use MSYS2. Another workaround is to put more complex DSL ex
 A third workaround is to replace `"` with `"""`, then `'` with `"`:
 
 ![pix/miller-windows-triple-double-quote.png](pix/miller-windows-triple-double-quote.png)
+
+A fourth workaround is `mlr -s`: see [Scripting with Miller](scripting.md).

docs/src/miller-on-windows.md.in

@@ -39,3 +39,5 @@ One workaround is to use MSYS2. Another workaround is to put more complex DSL ex
 A third workaround is to replace `"` with `"""`, then `'` with `"`:
 
 ![pix/miller-windows-triple-double-quote.png](pix/miller-windows-triple-double-quote.png)
+
+A fourth workaround is `mlr -s`: see [Scripting with Miller](scripting.md).

docs/src/scripting.md

@@ -105,6 +105,22 @@ circle   3     0.3
 }
 </pre>
 
+<pre class="pre-highlight-in-pair">
+<b>example-shell-script --ojson then filter '$count == 3' example.csv</b>
+</pre>
+<pre class="pre-non-highlight-in-pair">
+{
+  "shape": "triangle",
+  "count": 3,
+  "count_fraction": 0.3
+}
+{
+  "shape": "circle",
+  "count": 3,
+  "count_fraction": 0.3
+}
+</pre>
+
 etc.
 
 ## Miller scripts
@@ -173,6 +189,22 @@ circle   3     0.3
 }
 </pre>
 
+<pre class="pre-highlight-in-pair">
+<b>example-mlr-s-script --ojson then filter '$count == 3' example.csv</b>
+</pre>
+<pre class="pre-non-highlight-in-pair">
+{
+  "shape": "triangle",
+  "count": 3,
+  "count_fraction": 0.3
+}
+{
+  "shape": "circle",
+  "count": 3,
+  "count_fraction": 0.3
+}
+</pre>
+
 ## Miller scripts on Windows
 
 Both the previous options require executable mode with `chmod`, and a _shebang
@@ -230,4 +262,20 @@ circle   3     0.3
 }
 </pre>
 
-and so on.
+<pre class="pre-highlight-in-pair">
+<b>mlr -s example-mlr-s-script-no-shebang --ojson then filter '$count == 3' example.csv</b>
+</pre>
+<pre class="pre-non-highlight-in-pair">
+{
+  "shape": "triangle",
+  "count": 3,
+  "count_fraction": 0.3
+}
+{
+  "shape": "circle",
+  "count": 3,
+  "count_fraction": 0.3
+}
+</pre>
+
+and so on. See also [Miller on Windows](miller-on-windows.md).

docs/src/scripting.md.in

@@ -46,6 +46,10 @@ GENMD-RUN-COMMAND
 example-shell-script --ojson example.csv
 GENMD-EOF
 
+GENMD-RUN-COMMAND
+example-shell-script --ojson then filter '$count == 3' example.csv
+GENMD-EOF
+
 etc.
 
 ## Miller scripts
@@ -78,6 +82,10 @@ GENMD-RUN-COMMAND
 example-mlr-s-script --ojson example.csv
 GENMD-EOF
 
+GENMD-RUN-COMMAND
+example-mlr-s-script --ojson then filter '$count == 3' example.csv
+GENMD-EOF
+
 ## Miller scripts on Windows
 
 Both the previous options require executable mode with `chmod`, and a _shebang
@@ -106,4 +114,8 @@ GENMD-RUN-COMMAND
 mlr -s example-mlr-s-script-no-shebang --ojson example.csv
 GENMD-EOF
 
-and so on.
+GENMD-RUN-COMMAND
+mlr -s example-mlr-s-script-no-shebang --ojson then filter '$count == 3' example.csv
+GENMD-EOF
+
+and so on. See also [Miller on Windows](miller-on-windows.md).

todo.txt

@@ -9,7 +9,6 @@ PUNCHDOWN LIST
   - license triple-checks
   - `mlr put` -> coverart
   - 0b1011 olh/webdoc
-  - shebang
   - big-picture note
   ? array/map fields: marshal as JSON_SINGLE_LINE