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

+39 -65
View File
@@ -129,9 +129,9 @@
<h2 id="author"><a name="author"></a>Author:</h2>
<ul>
<li>Name: <a href="../../authors.html#Ron_McFarland">Ron
McFarland</a><br> Location: <a href="../../location.html#US">US</a> -
<em>United States of America</em> (<em>United States</em>) <br><br></li>
<li>Name: <a href="../../authors.html#Ron_McFarland">Ron McFarland</a><br>
Location: <a href="../../location.html#US">US</a> - <em>United States of America</em> (<em>United States</em>)
<br><br></li>
</ul>
<!-- END: next line ends content generated by: bin/output-index-author.sh -->
@@ -150,92 +150,66 @@ McFarland</a><br> Location: <a href="../../location.html#US">US</a> -
<h2 id="judges-remarks">Judges’ remarks:</h2>
<p>For a good no-op 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="fu">gzip</span> <span class="at">-c</span> <span class="op">&lt;</span> rcm.c <span class="kw">|</span> <span class="ex">./rcm</span></span></code></pre></div>
<p>NOTE: this is done in the <a href="try.sh">try.sh</a> script as well,
along with some other commands including a way to do the above command
but with more steps.</p>
<p>NOTE: this is done in the <a href="try.sh">try.sh</a> script as well, along with some other
commands including a way to do the above command but with more steps.</p>
<h2 id="authors-remarks">Author’s remarks:</h2>
<p>Except for some silly requirements regarding input validation, CRC
checking, and similar unimportant fluff, this program is a fully
compliant <a href="https://www.ietf.org/rfc/rfc1951.txt">RFC1951</a>/<a
href="https://www.ietf.org/rfc/rfc1952.txt">RFC1952</a> (<a
href="https://www.gnu.org/software/gzip/">GNU Gzip</a>) file
uncompressor. Feed it a <code>gzip</code> compressed file on standard
input, and it will write the fully uncompressed original file to
standard output.</p>
<h3 id="objustifications-for-this-entry">ObJustifications for this
entry:</h3>
<h4 id="the-design-trade-off-argument">The Design Trade-off
Argument:</h4>
<p>Except for some silly requirements regarding input validation, CRC checking, and
similar unimportant fluff, this program is a fully compliant
<a href="https://www.ietf.org/rfc/rfc1951.txt">RFC1951</a>/<a href="https://www.ietf.org/rfc/rfc1952.txt">RFC1952</a>
(<a href="https://www.gnu.org/software/gzip/">GNU Gzip</a>) file uncompressor. Feed it a
<code>gzip</code> compressed file on standard input, and it will write the fully
uncompressed original file to standard output.</p>
<h3 id="objustifications-for-this-entry">ObJustifications for this entry:</h3>
<h4 id="the-design-trade-off-argument">The Design Trade-off Argument:</h4>
<p>“The 184 characters worth of defines in the build file have been
carefully offset by 184 redundant and unnecessary ‘<code>{</code>’,
‘<code>}</code>’, and ‘<code>;</code>’ characters in the source
file.”</p>
carefully offset by 184 redundant and unnecessary ‘<code>{</code>’, ‘<code>}</code>’, and ‘<code>;</code>’
characters in the source file.”</p>
<h4 id="the-design-review-argument">The Design Review Argument:</h4>
<p>“Using only 216 characters out of a maximum of 256, the build file
meets and actually exceeds specification.”</p>
<h4 id="the-program-metrics-argument">The Program Metrics Argument:</h4>
<p>“The program source is less than 3,100 characters in length and
uncompresses the file <a
href="https://ftp.gnu.org/old-gnu/emacs/emacs-19.34b.tar.gz">emacs-19.34b.tar.gz</a>
in about 130 seconds on my HP 9000/735. The now obsolete source file
`inflate.c’ from the GNU gzip source tree is 31,613 characters in length
and uncompresses the emacs distribution file in slightly under 25
seconds. Thus:</p>
<p>“The program source is less than 3,100 characters in length and uncompresses the
file
<a href="https://ftp.gnu.org/old-gnu/emacs/emacs-19.34b.tar.gz">emacs-19.34b.tar.gz</a> in
about 130 seconds on my HP 9000/735. The now obsolete source file `inflate.c’
from the GNU gzip source tree is 31,613 characters in length and uncompresses
the emacs distribution file in slightly under 25 seconds. Thus:</p>
<pre><code>3100 / 130 = 23.85 -vs- 31613 / 25 = 1264.52</code></pre>
<p>which represents a better than 530% improvement in the ratio of
source file size to execution time.”</p>
<h4 id="the-whining-programmers-argument">The Whining Programmer’s
Argument:</h4>
<p>“The inflate algorithm requires that over 400 characters worth of
constants and tables be defined. Which means the program itself had to
be squeezed down to about 1,100 IOCCC countable bytes.”</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>
<h4 id="the-whining-programmers-argument">The Whining Programmer’s Argument:</h4>
<p>“The inflate algorithm requires that over 400 characters worth
of constants and tables be defined. Which means the program
itself had to be squeezed down to about 1,100 IOCCC countable
bytes.”</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-1996rcm"><a name="inventory"></a>Inventory for
1996/rcm</h1>
<h1 id="inventory-for-1996rcm"><a name="inventory"></a>Inventory for 1996/rcm</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/1996/rcm/rcm.c">rcm.c</a>
- entry source</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1996/rcm/Makefile">Makefile</a>
- entry Makefile</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1996/rcm/rcm.orig.c">rcm.orig.c</a>
- original source</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1996/rcm/try.sh">try.sh</a>
- how to run</li>
<li><a href="1996_rcm.tar.bz2">1996_rcm.tar.bz2</a> - download entry
source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1996/rcm/rcm.c">rcm.c</a> - entry source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1996/rcm/Makefile">Makefile</a> - entry Makefile</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1996/rcm/rcm.orig.c">rcm.orig.c</a> - original source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1996/rcm/try.sh">try.sh</a> - how to run</li>
<li><a href="1996_rcm.tar.bz2">1996_rcm.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/1996/rcm/.entry.json">.entry.json</a>
- description of entry in JSON</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1996/rcm/.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/1996/rcm/.entry.json">.entry.json</a> - description of entry in JSON</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1996/rcm/.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/1996/rcm/README.md">README.md</a>
- markdown source for index.html</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1996/rcm/README.md">README.md</a> - markdown source for index.html</li>
<li><a href="rfc1951.gz">rfc1951.gz</a> - input data</li>
<li><a href="rfc1952.gz">rfc1952.gz</a> - input data</li>
</ul>