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

+40 -68
View File
@@ -130,8 +130,8 @@
<h2 id="author"><a name="author"></a>Author:</h2>
<ul>
<li>Name: <a href="../../authors.html#Jack_Applin">Jack Applin</a><br>
Location: <a href="../../location.html#US">US</a> - <em>United States of
America</em> (<em>United States</em>) <br><br></li>
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 -->
@@ -141,98 +141,70 @@ America</em> (<em>United States</em>) <br><br></li>
<h2 id="to-build">To build:</h2>
<div class="sourceCode" id="cb1"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb1-1"><a href="#cb1-1" aria-hidden="true" tabindex="-1"></a><span class="fu">make</span> all</span></code></pre></div>
<p>A smaller version, originally called <code>zsmall.c</code> (and still
exists as such, as the source of the alt code), of <a
href="applin.c">applin.c</a>, can be found in <a
href="applin.alt.c">applin.alt.c</a>. Your machine may have an easier
time with this program. See the <a href="#alternate-code">Alternate
code</a> section below for details.</p>
<p>A smaller version, originally called <code>zsmall.c</code> (and still exists as such, as
the source of the alt code), of <a href="applin.c">applin.c</a>, can be found in
<a href="applin.alt.c">applin.alt.c</a>. Your machine may have an easier time with this
program. See the <a href="#alternate-code">Alternate code</a> section below for details.</p>
<h2 id="try">Try:</h2>
<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="ex">./applin</span></span></code></pre></div>
<h2 id="alternate-code">Alternate code:</h2>
<p>As noted above a smaller version can be used in case your
<code>cpp</code> has a hard time with this entry.</p>
<p>As noted above a smaller version can be used in case your <code>cpp</code> has a hard time
with this entry.</p>
<h3 id="alternate-build">Alternate build:</h3>
<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="fu">make</span> alt</span></code></pre></div>
<p>Use <code>applin.alt</code> as you would <code>applin</code>
above.</p>
<h4 id="history-about-the-smaller-version">History about the smaller
version:</h4>
<p>Use <code>applin.alt</code> as you would <code>applin</code> above.</p>
<h4 id="history-about-the-smaller-version">History about the smaller version:</h4>
<p>Way back in 1988 ..</p>
<p>This entry took 75 minutes to compile on a Amdahl 5980-300E (a 55658
Dhyrstone/sec/cpu machine) using the System V <code>cpp</code>. (The GNU
<code>cpp</code> when defined as <code>BIG_CPP</code> took only 45
seconds.)</p>
<p>Your <code>cpp</code> may not be able to compile it due to a common
bug that results in <code>cpp</code> running out of space. The routine
<a href="zsmall.c">zsmall</a> is a smaller version of the <a
href="applin.c">applin.c</a> entry.</p>
Dhyrstone/sec/cpu machine) using the System V <code>cpp</code>. (The GNU <code>cpp</code> when defined as
<code>BIG_CPP</code> took only 45 seconds.)</p>
<p>Your <code>cpp</code> may not be able to compile it due to a common bug that results in
<code>cpp</code> running out of space. The routine <a href="zsmall.c">zsmall</a> is a smaller version
of the <a href="applin.c">applin.c</a> entry.</p>
<h2 id="judges-remarks">Judges’ remarks:</h2>
<p>This entry is by far the most unusual abuse of the C preprocessor
that we have received thus far. Nearly all of the real work is done in
the C preprocessor!</p>
<p>When we compiled <a href="applin.c">applin.c</a> on an <a
href="https://en.wikipedia.org/wiki/Amdahl_Corporation">Amdahl</a>
5890-300E, we found that it spent over 75 minutes in the System V C
preprocessor! Besides showing that the standard System V
<code>cpp</code> is slow, it showed that it contained a memory usage
problem. The <a href="applin.c">applin.c</a> only uses 29 different
preprocessor symbols (besides <code>stdio.h</code>) and yet the
preprocessor ran out of space!</p>
<p>This entry is by far the most unusual abuse of the C preprocessor that
we have received thus far. Nearly all of the real work is done in the
C preprocessor!</p>
<p>When we compiled <a href="applin.c">applin.c</a> on an
<a href="https://en.wikipedia.org/wiki/Amdahl_Corporation">Amdahl</a> 5890-300E, we found that it
spent over 75 minutes in the System V C preprocessor! Besides showing that the
standard System V <code>cpp</code> is slow, it showed that it contained a memory usage
problem. The <a href="applin.c">applin.c</a> only uses 29 different preprocessor symbols
(besides <code>stdio.h</code>) and yet the preprocessor ran out of space!</p>
<p>The GNU C preprocessor took under 45 seconds to perform the 2nd pass
on the Amdahl 5890-300E. But due to the ANSI-likeness of GNU
<code>cpp</code> (v. 1-21), it was not able to cleanly substitute a
symbol that began with a ‘#’. Clearly the GNU C preprocessor is
faster.</p>
on the Amdahl 5890-300E. But due to the ANSI-likeness of GNU <code>cpp</code> (v. 1-21),
it was not able to cleanly substitute a symbol that began with a ‘#’.
Clearly the GNU C preprocessor is faster.</p>
<h2 id="authors-remarks">Author’s remarks:</h2>
<p>No remarks were provided by the author.</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>
<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-1988applin"><a name="inventory"></a>Inventory for
1988/applin</h1>
<h1 id="inventory-for-1988applin"><a name="inventory"></a>Inventory for 1988/applin</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/1988/applin/applin.c">applin.c</a>
- entry source</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1988/applin/Makefile">Makefile</a>
- entry Makefile</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1988/applin/applin.alt.c">applin.alt.c</a>
- alternative source</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1988/applin/applin.orig.c">applin.orig.c</a>
- original source</li>
<li><a href="1988_applin.tar.bz2">1988_applin.tar.bz2</a> - download
entry source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1988/applin/applin.c">applin.c</a> - entry source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1988/applin/Makefile">Makefile</a> - entry Makefile</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1988/applin/applin.alt.c">applin.alt.c</a> - alternative source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1988/applin/applin.orig.c">applin.orig.c</a> - original source</li>
<li><a href="1988_applin.tar.bz2">1988_applin.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/1988/applin/.entry.json">.entry.json</a>
- description of entry in JSON</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1988/applin/.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/1988/applin/.entry.json">.entry.json</a> - description of entry in JSON</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1988/applin/.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/1988/applin/README.md">README.md</a>
- markdown source for index.html</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1988/applin/README.md">README.md</a> - markdown source for index.html</li>
</ul>
<!-- END: next line ends content generated by: bin/output-index-inventory.sh -->