force use of pandoc version >= 3.1.12.2

The `bin/pandoc-wrapper.sh` tool will verify that the ssytem
has a recent enough version of `pandoc(1)`.

We explain why we insist on `pandoc(1)`. version >= 3.1.12.2
in comments where the $PANDOC_MIN_VERSION is set.

Added `--wrap=preserve` as a default argument to `pandoc(1)`.
While this change will impact every HTML file generated,
we believe this will improve the ability of someone to look
at the generated HTML and correlate with the original markdown.

Changed `bin/pandoc-wrapper.sh` VERSION from "1.4.2 2024-03-17"
to "1.4.3 2024-03-18".

Performed `make www` to achieve all of the above and to generate
HTML using the new  `--wrap=preserve` `pandoc(1)` mode.
This commit is contained in:
Landon Curt Noll committed 2024-03-18 01:26:39 -07:00
1 parent 9eb7a54e9f
commit b0b212acb1
402 files changed
+37061 -55132

No files matched your search

+100 -145
View File
@@ -129,15 +129,15 @@
<h2 id="authors"><a name="author"></a>Authors:</h2>
<ul>
<li>Name: <a href="../../authors.html#James_A_Woods">James A.
Woods</a><br> Location: <a href="../../location.html#ZZ">ZZ</a> -
<em>Unknown location</em> <br><br></li>
<li>Name: <a href="../../authors.html#James_A_Woods">James A. Woods</a><br>
Location: <a href="../../location.html#ZZ">ZZ</a> - <em>Unknown location</em>
<br><br></li>
<li>Name: <a href="../../authors.html#Karl_F_Fox">Karl F. Fox</a><br>
Location: <a href="../../location.html#ZZ">ZZ</a> - <em>Unknown
location</em> <br><br></li>
Location: <a href="../../location.html#ZZ">ZZ</a> - <em>Unknown location</em>
<br><br></li>
<li>Name: <a href="../../authors.html#Paul_Eggert">Paul Eggert</a><br>
Location: <a href="../../location.html#ZZ">ZZ</a> - <em>Unknown
location</em> <br><br></li>
Location: <a href="../../location.html#ZZ">ZZ</a> - <em>Unknown location</em>
<br><br></li>
</ul>
<!-- END: next line ends content generated by: bin/output-index-author.sh -->
@@ -150,8 +150,8 @@ location</em> <br><br></li>
<h2 id="try">Try:</h2>
<p>To test the official C entry, one might try:</p>
<div class="sourceCode" id="cb2"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb2-1"><a href="#cb2-1" aria-hidden="true" tabindex="-1"></a><span class="bu">echo</span> <span class="st">&quot;Quartz glyph jocks vend, fix, BMW.&quot;</span> <span class="kw">|</span> <span class="ex">compress</span> <span class="kw">|</span> <span class="ex">./btoa</span> <span class="kw">|</span> <span class="ex">./jaw</span></span></code></pre></div>
<p>which should apply the identity transformation to a minimal
holoalphabetic sentence.</p>
<p>which should apply the identity transformation to a minimal holoalphabetic
sentence.</p>
<h4 id="also-try">Also try:</h4>
<div class="sourceCode" id="cb3"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb3-1"><a href="#cb3-1" aria-hidden="true" tabindex="-1"></a><span class="ex">./try.sh</span></span></code></pre></div>
<h2 id="judges-remarks">Judges’ remarks:</h2>
@@ -160,69 +160,58 @@ holoalphabetic sentence.</p>
<li><code>atob</code> - ASCII to binary conversion</li>
<li><code>zcat</code> - decompression filter</li>
</ul>
<p>Included with this entry is a shell script (with comments edited down
to reduce it to 1530 bytes) which implements the complete shark utility.
The script, <a href="shark.sh">shark.sh</a>, contains a
<code>jaw.c</code> embedded within it!</p>
<p>The sender must have <code>compress</code> and <code>btoa</code>. To
send, try:</p>
<p>Included with this entry is a shell script (with comments edited down to reduce
it to 1530 bytes) which implements the complete shark utility. The script,
<a href="shark.sh">shark.sh</a>, contains a <code>jaw.c</code> embedded within it!</p>
<p>The sender must have <code>compress</code> and <code>btoa</code>. To send, try:</p>
<div class="sourceCode" id="cb4"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb4-1"><a href="#cb4-1" aria-hidden="true" tabindex="-1"></a><span class="ex">./shark.sh</span> jaw.<span class="pp">*</span> README.md <span class="op">&gt;</span> receive</span></code></pre></div>
<p>The resulting file, <code>receive</code>, unpacks the input files
even if the receiver lacks <code>uncompress</code> and
<code>btoa</code>:</p>
even if the receiver lacks <code>uncompress</code> and <code>btoa</code>:</p>
<div class="sourceCode" id="cb5"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb5-1"><a href="#cb5-1" aria-hidden="true" tabindex="-1"></a><span class="fu">mkdir</span> <span class="at">-p</span> test</span>
<span id="cb5-2"><a href="#cb5-2" aria-hidden="true" tabindex="-1"></a><span class="bu">cd</span> test</span>
<span id="cb5-3"><a href="#cb5-3" aria-hidden="true" tabindex="-1"></a><span class="fu">sh</span> ../receive</span>
<span id="cb5-4"><a href="#cb5-4" aria-hidden="true" tabindex="-1"></a><span class="fu">cmp</span> ../jaw.c jaw.c</span>
<span id="cb5-5"><a href="#cb5-5" aria-hidden="true" tabindex="-1"></a><span class="fu">cmp</span> ../README.md README.md</span></code></pre></div>
<p>NOTE: a limitation is that the script should be in the parent
directory of the directory it is run from.</p>
<p>NOTE: a limitation is that the script should be in the parent directory of the
directory it is run from.</p>
<h2 id="authors-remarks">Authors’ remarks:</h2>
<h3 id="abstract">ABSTRACT</h3>
<h4
id="minimal-universal-file-bundling-or-functional-obfuscation-in-a-self-decoding-unix-shell-archive">Minimal,
Universal File Bundling (or, Functional Obfuscation in a Self-Decoding
Unix Shell Archive)</h4>
<h4 id="minimal-universal-file-bundling-or-functional-obfuscation-in-a-self-decoding-unix-shell-archive">Minimal, Universal File Bundling (or, Functional Obfuscation in a Self-Decoding Unix Shell Archive)</h4>
<p>James A. Woods<br />
Universities Space Research Association<br />
NASA Ames Research Center</p>
<hr />
<blockquote>
<p>“Use an algorithm, go to jail.”</p>
<p>– anon., circa 1988, pre-<a
href="https://en.wikipedia.org/wiki/Morris_worm">Morris worm</a> era</p>
<p>– anon., circa 1988, pre-<a href="https://en.wikipedia.org/wiki/Morris_worm">Morris worm</a> era</p>
</blockquote>
<hr />
<p>Myriad formats have been proposed for network-mailable data. A major
difficulty undermining the popularity of most file/message bundlers is
that the sender assumes prior installation of the computational dual of
such bundling software by the receiver. Command shell archives alleviate
this problem somewhat, but still require standardization for the
function of data compression and mail-transparency encoding. On Unix,
these coding format quandaries are overcome by planting a novel <a
href="https://en.wikipedia.org/wiki/Trojan_horse_(computing)">Trojan
Horse</a> in the archive header to perform negotiation-less
decoding.</p>
<p>Specifically, we outline the development of an extraordinarily
compact portable bundler/extractor to (dis)assemble data-compressed,
binary-to-ASCII-converted, length-split, and checksummed directory
structures using standard Unix tools. Miniature versions of counterparts
to a Lempel-Ziv coder (<code>compress</code> or <code>squeeze</code>)
and an efficient bit packetizer (<code>btoa</code>) are compiled
on-the-fly at mail destination sites where they may not already exist.
These are written in purposefully obfuscated-C to accompany
similarly-shrunk shell command glue. This resulting shell archiver is
dubbed <code>shark</code>.</p>
<p><code>shark</code> procedure overhead consumes as few as three dozen
shell commands (or <code>~1100</code> bytes), commensurate with the size
of many Internet mail headers; it amortizes favorably with message size.
<code>shark</code> is portable across Unix variants, while the
underlying technique is inherently generalizable to other encoding
schemes.</p>
<p>In the function-theoretic sense of minimal Chaitin/Kolmogorov
complexity, and within a modified Shannon model of communication, the
‘shark’ effort aims to construct a “shortest program” for source
decoding in the Turing-universal Unix environment.</p>
<p>Myriad formats have been proposed for network-mailable data. A major difficulty
undermining the popularity of most file/message bundlers is that the sender
assumes prior installation of the computational dual of such bundling software
by the receiver. Command shell archives alleviate this problem somewhat, but
still require standardization for the function of data compression and
mail-transparency encoding. On Unix, these coding format quandaries are overcome
by planting a novel <a href="https://en.wikipedia.org/wiki/Trojan_horse_(computing)">Trojan
Horse</a> in the archive
header to perform negotiation-less decoding.</p>
<p>Specifically, we outline the development of an extraordinarily compact portable
bundler/extractor to (dis)assemble data-compressed, binary-to-ASCII-converted,
length-split, and checksummed directory structures using standard Unix tools.
Miniature versions of counterparts to a Lempel-Ziv coder (<code>compress</code> or
<code>squeeze</code>) and an efficient bit packetizer (<code>btoa</code>) are compiled on-the-fly at
mail destination sites where they may not already exist. These are written in
purposefully obfuscated-C to accompany similarly-shrunk shell command glue. This
resulting shell archiver is dubbed <code>shark</code>.</p>
<p><code>shark</code> procedure overhead consumes as few as three dozen shell commands (or
<code>~1100</code> bytes), commensurate with the size of many Internet mail headers; it
amortizes favorably with message size. <code>shark</code> is portable across Unix
variants, while the underlying technique is inherently generalizable to other
encoding schemes.</p>
<p>In the function-theoretic sense of minimal Chaitin/Kolmogorov complexity, and
within a modified Shannon model of communication, the ‘shark’ effort aims to
construct a “shortest program” for source decoding in the Turing-universal Unix
environment.</p>
<hr />
<blockquote>
<p>Oh, the shark has pretty teeth, dear–<br />
@@ -234,11 +223,10 @@ And he keeps it out of sight.<br />
</blockquote>
<hr />
<h3 id="portability">Portability</h3>
<p>We have ported this program to a wide variety of systems. Among these
are:</p>
<p>We have ported this program to a wide variety of systems. Among
these are:</p>
<ul>
<li>SunOS 4.1 / Sun SPARCstation 1 (using both ‘cc’ and ‘gcc
1.37.1’)</li>
<li>SunOS 4.1 / Sun SPARCstation 1 (using both ‘cc’ and ‘gcc 1.37.1’)</li>
<li>SunOS 4.0.3 / Sun 3</li>
<li>BSD 4.3 / VAX 8650</li>
<li>SEIUX / Sumitomo Electric Ustation/S</li>
@@ -246,39 +234,33 @@ are:</p>
<li>System V.? / Hitachi 2050</li>
<li>System V.? / NEC EWS 4800</li>
<li>UNIOS-B / Omron Luna</li>
<li>Dynix / Sequent Balance (‘cc’ for Natl. Semi. base + ‘gcc
1.36’)</li>
<li>Dynix / Sequent Balance (‘cc’ for Natl. Semi. base + ‘gcc 1.36’)</li>
<li>Unicos / Cray 2</li>
</ul>
<h3 id="obfuscation">Obfuscation</h3>
<p>We (the authors) feel this program is obfuscated for the following
reasons:</p>
<p>We (the authors) feel this program is obfuscated for the
following reasons:</p>
<ol start="0" type="1">
<li><p>This is one of the few programs you’ll see <em>WHOSE VERY UTILITY
DEPENDS ON ITS OBFUSCATION</em>!</p></li>
<li><p>The contest entry may be used to send its wonderful self to
anyone in the Unix world! Virus writers need not apply…</p></li>
<li><p>The basic idea is twisted enough to be patentable, but is, out of
the kindness of our hearts (as well as to maintain eligibility for the
large IOCCC prize fund), dedicated to the public domain. Claude Shannon,
meet Alan Turing.</p></li>
<li><p>Meta-obfuscation is via obfuscated description (see
<em>ABSTRACT</em>).</p></li>
<li><p>“Literary” allusion. Production code contains a reference to
self-reference, preserved at amazing cost for sheer perversity.</p></li>
<li><p>Many, many micro obfuscations below, honed over three years time,
in shell as well as C. Ask about the ‘tar’ pit escape, the
<code>argv[0]</code> flip, Paul’s <code>&amp;4294967295</code>
portability hack, the “void where prohibited by flaw” fix, the
<code>scanf()</code> space-saver, shift shenanigans, signal madness,
<code>exit()</code>ing stage left, and source-to-source transformations
galore.</p></li>
<li><p>This is one of the few programs you’ll see <em>WHOSE VERY UTILITY DEPENDS ON ITS
OBFUSCATION</em>!</p></li>
<li><p>The contest entry may be used to send its wonderful self to anyone in the
Unix world! Virus writers need not apply…</p></li>
<li><p>The basic idea is twisted enough to be patentable, but is, out of the
kindness of our hearts (as well as to maintain eligibility for the large IOCCC
prize fund), dedicated to the public domain. Claude Shannon, meet Alan Turing.</p></li>
<li><p>Meta-obfuscation is via obfuscated description (see <em>ABSTRACT</em>).</p></li>
<li><p>“Literary” allusion. Production code contains a reference to self-reference,
preserved at amazing cost for sheer perversity.</p></li>
<li><p>Many, many micro obfuscations below, honed over three years time, in shell as
well as C. Ask about the ‘tar’ pit escape, the <code>argv[0]</code> flip, Paul’s
<code>&amp;4294967295</code> portability hack, the “void where prohibited by flaw” fix, the
<code>scanf()</code> space-saver, shift shenanigans, signal madness, <code>exit()</code>ing stage
left, and source-to-source transformations galore.</p></li>
</ol>
<h3 id="for-extra-credit">For extra credit:</h3>
<p>Construct <code>sharkmail</code>, to auto-split
<code>sharkives</code> into mailable segments and mail them. Here’s a
simple one, which could be extended to enable auto-reassembly with one
shell cmd at the far end.</p>
<p>Construct <code>sharkmail</code>, to auto-split <code>sharkives</code> into mailable segments and mail
them. Here’s a simple one, which could be extended to enable auto-reassembly
with one shell cmd at the far end.</p>
<div class="sourceCode" id="cb6"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb6-1"><a href="#cb6-1" aria-hidden="true" tabindex="-1"></a><span class="co">#!/bin/sh</span></span>
<span id="cb6-2"><a href="#cb6-2" aria-hidden="true" tabindex="-1"></a><span class="va">m</span><span class="op">=</span><span class="va">$1</span><span class="kw">;</span> <span class="bu">shift</span></span>
<span id="cb6-3"><a href="#cb6-3" aria-hidden="true" tabindex="-1"></a><span class="ex">shark</span> <span class="va">$*</span> <span class="kw">|</span> <span class="fu">split</span> <span class="at">-800</span> <span class="at">-</span> /tmp/shark<span class="va">$$</span></span>
@@ -292,88 +274,61 @@ shell cmd at the far end.</p>
<span id="cb6-11"><a href="#cb6-11" aria-hidden="true" tabindex="-1"></a><span class="fu">rm</span> /tmp/shark<span class="va">$$</span><span class="pp">*</span></span></code></pre></div>
<h3 id="shark-history">Shark history:</h3>
<ul>
<li><p>May 1987: Karl Fox introduces 1023-byte <code>zcat.c</code> to
USENET. It’s too late for the 4th IOCCC.</p></li>
<li><p>May 1987: Karl Fox introduces 1023-byte <code>zcat.c</code> to USENET.
It’s too late for the 4th IOCCC.</p></li>
<li><p>May 21, 1987: James A. Woods extends idea to construct self
decompressing <code>shar</code> Trojan horse, utilizing <code>cc</code>,
<code>shar</code>, <code>zcat</code>, &amp; <code>btoa</code>; size:
2303 bytes.</p></li>
<li><p>May 23, 1987: <code>jaw</code> trims 250 bytes without much
thought.</p></li>
<li><p>June 2, 1987: 52 lines of shell, 1991 bytes, now made with
<code>tar</code>, short-circuit C-compile at far end, dual-use main.c,
decompressing <code>shar</code> Trojan horse, utilizing <code>cc</code>, <code>shar</code>,
<code>zcat</code>, &amp; <code>btoa</code>; size: 2303 bytes.</p></li>
<li><p>May 23, 1987: <code>jaw</code> trims 250 bytes without much thought.</p></li>
<li><p>June 2, 1987: 52 lines of shell, 1991 bytes, now made with <code>tar</code>,
short-circuit C-compile at far end, dual-use main.c,
portability mods. (jaw)</p></li>
<li><p>Mar-May 1988: abortive run at 5th IOCCC. <code>jaw.c</code> -
1529 bytes. compile line: 152 bytes. generated funny code with
<code>execvp()</code> to invoke shell.</p></li>
<li><p>Mar-May 1988: abortive run at 5th IOCCC.
<code>jaw.c</code> - 1529 bytes. compile line: 152 bytes.
generated funny code with <code>execvp()</code> to invoke shell.</p></li>
<li><p>Aug 29, 1988: production version, now at 1830 bytes.</p></li>
<li><p>Jan 1990: Paul Eggert does tour-de-force shark
re-engineering.</p></li>
<li><p>May 24, 1990: collaboration yields 999-byte <code>jaw.c</code>
core (see above) and 1530-byte production shell code (w/comments).
Eggert comes through with lion’s share of improvements. 7th IOCCC code
now faster than the <code>btoa</code>/<code>zcat</code> it
replaces.</p></li>
<li><p>May 1990: <code>jaw</code> develops experimental replacement
using Dan Bernstein’s high-compression ‘squeeze’.</p></li>
<li><p>Jan 1990: Paul Eggert does tour-de-force shark re-engineering.</p></li>
<li><p>May 24, 1990: collaboration yields 999-byte <code>jaw.c</code> core (see above)
and 1530-byte production shell code (w/comments).
Eggert comes through with lion’s share of improvements.
7th IOCCC code now faster than the <code>btoa</code>/<code>zcat</code> it replaces.</p></li>
<li><p>May 1990: <code>jaw</code> develops experimental replacement using
Dan Bernstein’s high-compression ‘squeeze’.</p></li>
</ul>
<p>To which we add:</p>
<ul>
<li>June 1990: <code>shark</code> wins the IOCCC, finally! :-)</li>
</ul>
<h2 id="copyright-and-cc-by-sa-4.0-license">Copyright and CC BY-SA 4.0
License:</h2>
<p>This file is Copyright (c) 2023 by Landon Curt Noll. All Rights
Reserved. You are free to share and adapt this file under the terms of
this license:</p>
<h2 id="copyright-and-cc-by-sa-4.0-license">Copyright and CC BY-SA 4.0 License:</h2>
<p>This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
You are free to share and adapt this file under the terms of this license:</p>
<pre><code>Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)</code></pre>
<p>For more information, see:
https://creativecommons.org/licenses/by-sa/4.0/</p>
<p>For more information, see: https://creativecommons.org/licenses/by-sa/4.0/</p>
<!-- END: this line ends content for HTML phase 21 by: bin/pandoc-wrapper.sh via bin/md2html.sh -->
<!-- START: this line starts content for HTML phase 22 by: bin/output-index-inventory.sh via bin/md2html.sh -->
<!-- START: this line starts content generated by: bin/output-index-inventory.sh -->
<h1 id="inventory-for-1990jaw"><a name="inventory"></a>Inventory for
1990/jaw</h1>
<h1 id="inventory-for-1990jaw"><a name="inventory"></a>Inventory for 1990/jaw</h1>
<p><a href="#top">Jump to top</a></p>
<h2 id="primary-files">Primary files</h2>
<ul>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1990/jaw/jaw.c">jaw.c</a>
- entry source</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1990/jaw/Makefile">Makefile</a>
- entry Makefile</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1990/jaw/jaw.orig.c">jaw.orig.c</a>
- original source</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1990/jaw/try.sh">try.sh</a>
- how to run</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1990/jaw/btoa">btoa</a>
- bota utility</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1990/jaw/shark.sh">shark.sh</a>
- shark utility with embedded source</li>
<li><a href="1990_jaw.tar.bz2">1990_jaw.tar.bz2</a> - download entry
source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1990/jaw/jaw.c">jaw.c</a> - entry source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1990/jaw/Makefile">Makefile</a> - entry Makefile</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1990/jaw/jaw.orig.c">jaw.orig.c</a> - original source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1990/jaw/try.sh">try.sh</a> - how to run</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1990/jaw/btoa">btoa</a> - bota utility</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1990/jaw/shark.sh">shark.sh</a> - shark utility with embedded source</li>
<li><a href="1990_jaw.tar.bz2">1990_jaw.tar.bz2</a> - download entry source</li>
</ul>
<h2 id="secondary-files">Secondary files</h2>
<ul>
<li><a href="index.html">index.html</a> - entry home page</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1990/jaw/.entry.json">.entry.json</a>
- description of entry in JSON</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1990/jaw/.gitignore">.gitignore</a>
- list of files that should not be committed under git</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1990/jaw/.entry.json">.entry.json</a> - description of entry in JSON</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1990/jaw/.gitignore">.gitignore</a> - list of files that should not be committed under git</li>
<li><a href=".path">.path</a> - directory path from top directory</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1990/jaw/README.md">README.md</a>
- markdown source for index.html</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1990/jaw/README.md">README.md</a> - markdown source for index.html</li>
</ul>
<!-- END: next line ends content generated by: bin/output-index-inventory.sh -->