build index.html for all winners

Updated manifest as per recent file changes.

Updated winner `.winner.json` to reflect the manifest changes.

Added [bin/all_run.sh](bin/all_run.sh) tool to run a command over
all winning entries.

These tools had slight improvements in the help usage message:

* bin/gen-author.sh VERSION="1.3.1 2024-01-16"
* bin/gen-inventory.sh VERSION="1.0.1 2024-01-16"
* bin/pandoc_wrapper.sh VERSION="1.3.1 2024-01-16"
* bin/subst.default.sh VERSION="1.1.1 2024-01-16"
* bin/subst.winner-index.sh VERSION="1.1.1 2024-01-16"

The `bin/readme2index.sh` tool was improved so that
if the `index.html` file exists and the tool forms
the exact same content, then the file `index.html`
file is NOT touched.

* bin/readme2index.sh VERSION="1.1 2024-01-16"

We used the following command to generate `index.html` files
for all winning entries:

```sh
bin/all_run.sh -v 3 bin/readme2index.sh
```

NOTE: We have not (yet) built HTML files above the winner directory
level (e.g., no year level nor top level HTML), nor have be built
non-index HTML files for winners.

NOTE: By default we are running `pandoc(1)` with:

```
--fail-if-warnings=true
```

This means that any problems with markdown to HTML
generates an error.  This is done to be sure that
the HTML conversion is clean.

We had to fix the following `README.md` files:

* `2000/rince/README.md`

The reference [^2] was never used.  We made a guess that [^2] applies
to the same spot as [^1].  Perhaps there is a better spot where
[^2] applies?

NOTE: For every reference, there MUST be some place where that
reference is used.

* 2012/vik/README.md

The string "$...$" is assumed to be a TeX encoded string.

NOTE: Every "$..$" needs to be backslashed as in "\$..\$".

* 2018/burton1/README.md

The reference [2] was duplicated.  We changed the
second [2] to [3].

NOTE: Every reference needs to have a unique number.

* 2020/carlini/README.md

The string "$...$" is assumed to be a TeX encoded string.

NOTE: Every "$..$" needs to be backslashed as in "\$..\$".

We also found 2 errors in the `author/author_handle.json` file set:

* author/Anonymous_2001.json

The `author/Anonymous_2001.json` file was missing.

* author/Jari_Arkko.json

The winner ID for `1989_jar.1` had a typo.

2015/muth/index.html

@@ -1,4 +1,6 @@
 <!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<!-- START: two lines up starts content from: inc/top.default.html -->
 <!-- -->
 <!-- !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -->
 <!-- !!! DO NOT MODIFY THIS FILE - This file is generated by a tool !!! -->
@@ -6,27 +8,312 @@
 <!-- !!! DO NOT MODIFY THIS FILE - This file is generated by a tool !!! -->
 <!-- !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -->
 <!-- -->
-<!-- file: 2015/muth/index.html created by: fake.gen_index.sh version: 1.0.5 2023-10-31 -->
-<html lang="en">
+<!-- END: this line ends content from: inc/top.default.html -->
+<!-- -->
+<!-- This file was formed by the tool: bin/readme2index.sh version: 1.1 2024-01-16 -->
+<!-- -->
+<!-- START: this line starts content from: inc/head.default.html -->
+
 <head>
-<meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>2015 muth</title>
-<meta name="description" content="IOCCC year: 2015 IOCCC winner: muth winner index page">
-<meta name="keywords" content="IOCCC,2015,muth,winner index page">
+<link rel="stylesheet" href="/temp-test-ioccc/ioccc.css">
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
+<title>2015/muth</title>
+<meta name="description" content="2015 IOCCC winner muth">
+<meta name="keywords" content="IOCCC, 2015, IOCCC 2015, IOCCC winner, muth">
 </head>
 
+<!-- END: this line ends content from: inc/head.default.html -->
+<!-- START: this line starts content from: inc/body.default.html -->
+
 <body>
 
-<h1>2015 muth</h1>
+<!-- END: this line ends content from: inc/body.default.html -->
+<!-- START: this line starts content from: inc/header.default.html -->
 
-<p>XXX - fake content until readme2index is working - XXX</p>
+<div class="header">
+  <img src="/temp-test-ioccc/png/ioccc.png" alt="IOCCC image by Matt Zucker" width=300 height=110>
+  <h1>The International Obfuscated C Code Contest</h1>
+  <h2>2015/muth</h2>
+</div>
 
-<hr style="width:50%;text-align:left;margin-left:0">
+<!-- END: this line ends content from: inc/header.default.html -->
+<!-- START: this line starts content from: inc/topnav.mid.html -->
 
-<!-- Start Nu Html Checker -->
-<p><a href="https://validator.w3.org/nu/?doc=https%3A%2F%2Fioccc-src.github.io%2Ftemp-test-ioccc%2F2015%2Fmuth%2Findex.html">Nu Html check https://ioccc-src.github.io/temp-test-ioccc/2015/muth/index.html</a></p>
-<!-- End Nu Html Checker -->
+<div class="topnav">
+  <a class="Left" href="../mills2/index.html">&larr; mills2</a>
+  <a class="Left" href="../index.html">&uarr; 2015 &uarr;</a>
+  <a class="Left" href="../schweikhardt/index.html">schweikhardt &rarr;</a>
+  <a class="Right" href="#inventory">Inventory</a>
+</div>
+
+<!-- END: this line ends content from: inc/topnav.mid.html -->
+<!-- START: this line starts content from: inc/begin-row.default.html -->
+
+<div class="row">
+
+<!-- END: this line ends content from: inc/begin-row.default.html -->
+<!-- START: this line starts content from: inc/begin-leftcolumn.default.html -->
+
+  <div class="leftcolumn">
+
+<!-- END: this line ends content from: inc/begin-leftcolumn.default.html -->
+<!-- START: this line starts content from: inc/sidenav.default.html -->
+
+    <div class="sidenav">
+      <a href="#content">Jump to contents</a>
+    </div>
+    <hr>
+    <div class="sidenav">
+      <a href="/temp-test-ioccc/index.html">IOCCC Home</a>
+      <a href="/temp-test-ioccc/years.html">Winning Entries</a>
+      <a href="/temp-test-ioccc/winners.html">People who have won</a>
+    </div>
+    <hr>
+    <div class="sidenav">
+      <a href="/temp-test-ioccc/news.html">IOCCC News</a>
+      <a href="/temp-test-ioccc/faq.html#submit">How to enter the IOCCC</a>
+      <a href="/temp-test-ioccc/faq.html">FAQ</a>
+    </div>
+    <hr>
+    <div class="sidenav">
+      <a href="/temp-test-ioccc/bugs.html">Bugs &amp; (mis)features</a>
+      <a href="/temp-test-ioccc/faq.html#fix_a_winner">Fixing IOCCC winners</a>
+      <a href="/temp-test-ioccc/faq.html#fix_web_site">Fixing the web site</a>
+      <a href="/temp-test-ioccc/faq.html#fix_author">Fixing winner info</a>
+      <a href="/temp-test-ioccc/thanks-for-help.html">Thanks for the help</a>
+    </div>
+    <hr>
+    <div class="sidenav">
+      <a href="/temp-test-ioccc/judges.html">The IOCCC Judges</a>
+      <a href="/temp-test-ioccc/contact.html">Contacting the IOCCC</a>
+    </div>
+    <hr>
+    <div class="sidenav">
+      <a href="#top">Jump to top</a>
+    </div>
+
+<!-- END: this line ends content from: inc/sidenav.default.html -->
+<!-- START: this line starts content from: inc/end-leftcolumn.default.html -->
+
+  </div>
+
+<!-- END: this line ends content from: inc/end-leftcolumn.default.html -->
+<!-- START: this line starts content from: inc/begin-rightcolumn.default.html -->
+
+  <div class="rightcolumn">
+
+<!-- END: this line ends content from: inc/begin-rightcolumn.default.html -->
+<!-- START: this line starts content from: inc/before-content.default.html -->
+
+    <a name="content"></a>
+
+<!-- END: this line ends content from: inc/before-content.default.html -->
+<!-- START: this line starts content generated by: bin/gen-author.sh -->
+
+<p><a name="author"><strong>Author:</strong></a> <br><br>Name: <a
+href="/temp-test-ioccc/winners.html#Dominik_Muth">Dominik Muth</a><br>
+Location: <a href="/temp-test-ioccc/location.html#DE">DE</a></p>
+
+<!-- END: next line ends content generated by: bin/gen-author.sh -->
+<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></span></code></pre></div>
+<h2 id="to-use">To use:</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="fu">make</span> <span class="at">-B</span> <span class="pp">[</span><span class="ss">MACHINE=your_machine.h</span><span class="pp">]</span> <span class="pp">[</span><span class="ss">TAPE=your_tape.h</span><span class="pp">]</span> [X=[0<span class="kw">|</span><span class="ex">1</span><span class="kw">|</span><span class="ex">2</span><span class="kw">|</span><span class="ex">3</span><span class="kw">|</span><span class="ex">4</span><span class="kw">|</span><span class="ex">5</span><span class="kw">|</span><span class="ex">6</span><span class="kw">|</span><span class="ex">7</span><span class="kw">|</span><span class="ex">8</span><span class="kw">|</span><span class="ex">9]]</span> [V=[0<span class="kw">|</span><span class="ex">1</span><span class="kw">|</span><span class="ex">2]]</span> run</span></code></pre></div>
+<h2 id="try">Try:</h2>
+<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>
+<p>This is something we were fearing all along: that the C preprocessor
+is Turing-complete even without conditionals and recursive file
+inclusion as some kind of a <a
+href="https://en.wikipedia.org/wiki/Rewriting">rewriting system</a>. Now
+we have the proof!</p>
+<h2 id="authors-remarks">Author’s remarks:</h2>
+<h3 id="preprocessor-turing-engine">Preprocessor Turing Engine</h3>
+<h3 id="features">Features</h3>
+<ul>
+<li>Turing machine runs in preprocessor</li>
+<li>universal (unlimited configurable states, symbols, and tape)</li>
+<li>no <code>#if</code>s or other conditional directives, only
+<code>#define</code>s</li>
+<li>no recursive <code>#include</code></li>
+<li>single compiler run (no repeated preprocessing)</li>
+<li>no variadic macros</li>
+<li>verbosity levels:
+<ul>
+<li><code>V=0</code> (default) only prints the final tape</li>
+<li><code>V=1</code> additionally prints one tilde character per machine
+step (slow)</li>
+<li><code>V=2</code> additionally prints details on each machine step
+(slow; generates large files)</li>
+</ul></li>
+<li>make target <code>run</code> runs <code>./prog</code> and filters a
+little statistics out of the verbose output</li>
+<li><code>X</code> (defaults to 3) sets the maximum number of steps:
+<em>M</em>(<code>X</code>) ~ 8<sup><code>X</code></sup></li>
+</ul>
+<h3 id="limitations">Limitations</h3>
+<p>If the machine does not halt after <em>M</em>(<code>X</code>) steps,
+you will see unexpanded macros in the output.</p>
+<h3 id="compiler-warnings">Compiler warnings</h3>
+<p>If <code>V=1</code> or <code>V=2</code> is used, you may see
+“<code>warning: string length is greater than the length '4095' ISO C99 compilers are required to support</code>”.</p>
+<h3 id="programming">Programming</h3>
+<p>Implementing your own Turing machine is easy. Take a look at the
+supplied header files for examples.</p>
+<h4 id="tape-symbols">Tape Symbols</h4>
+<p>Every symbol used (except <code>_</code>) must be explicitly declared
+using</p>
+<div class="sourceCode" id="cb4"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb4-1"><a href="#cb4-1" aria-hidden="true" tabindex="-1"></a><span class="pp">#define sym_SYMBOL</span><span class="op">(</span><span class="pp">sym</span><span class="op">,</span><span class="pp"> _SYMBOL</span><span class="op">)</span><span class="pp"> sym</span></span></code></pre></div>
+<p>Example:</p>
+<div class="sourceCode" id="cb5"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb5-1"><a href="#cb5-1" aria-hidden="true" tabindex="-1"></a><span class="pp">#define sym_1</span><span class="op">(</span><span class="pp">sym</span><span class="op">,</span><span class="pp"> _1</span><span class="op">)</span><span class="pp"> sym</span></span></code></pre></div>
+<h4 id="tape">Tape</h4>
+<p>The initial content of the tape must be defined in the tape header
+using a triple like:</p>
+<div class="sourceCode" id="cb6"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb6-1"><a href="#cb6-1" aria-hidden="true" tabindex="-1"></a><span class="pp">#define tape </span><span class="op">((((,),...</span><span class="pp">l2</span><span class="op">),</span><span class="pp"> l1</span><span class="op">),</span><span class="pp"> c</span><span class="op">,</span><span class="pp"> </span><span class="op">(</span><span class="pp">r1</span><span class="op">,</span><span class="pp"> </span><span class="op">(</span><span class="pp">r2</span><span class="op">...,</span><span class="pp"> </span><span class="op">(,))))</span></span></code></pre></div>
+<ul>
+<li><code>l1</code>, <code>l2</code>, … are the symbols to the left</li>
+<li><code>c</code> is the symbol at the current position</li>
+<li><code>r1</code>, <code>r2</code>, … are the symbols to the
+right</li>
+</ul>
+<p>The empty pairs <code>(,)</code> represent the continuations of the
+tape, filled with underscore symbols (<code>_</code>). They are expanded
+on demand.</p>
+<h4 id="state-machine">State Machine</h4>
+<p>All transitions are defined in the machine header using the
+syntax</p>
+<pre><code>#define CURRENT_SCANNED (WRITE, MOVEMENT, NEXT)</code></pre>
+<p>where</p>
+<ul>
+<li><code>CURRENT</code> is the current state.</li>
+<li><code>SCANNED</code> is the symbol at the current position.</li>
+<li>The whitespace before the parentheses is significant.</li>
+<li><code>WRITE</code> is the symbol to be written to the tape.</li>
+<li><code>MOVEMENT</code> is <code>L</code> for left, <code>R</code> for
+right; don’t specify anything if you want no movement.</li>
+<li><code>NEXT</code> is the next state.</li>
+</ul>
+<p>There must be a state <code>A</code> defined, which becomes the
+initial state of the machine.</p>
+<p>To halt the machine, use the keyword <code>break</code> as in</p>
+<div class="sourceCode" id="cb8"><pre class="sourceCode c"><code class="sourceCode c"><span id="cb8-1"><a href="#cb8-1" aria-hidden="true" tabindex="-1"></a><span class="pp">#define A_1 </span><span class="op">(</span><span class="dv">2</span><span class="op">,</span><span class="pp"> </span><span class="cf">break</span><span class="op">)</span></span></code></pre></div>
+<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>
+<!-- START: this line starts content generated by: bin/gen-inventory.sh -->
+
+<h1 id="inventory-for-2015muth"><a name="inventory"></a>Inventory for
+2015/muth</h1>
+<h2 id="primary-files">Primary files</h2>
+<ul>
+<li><a href="index.html">index.html</a> - winner home page</li>
+<li><a
+href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2015/muth/prog.c">prog.c</a>
+- winning source</li>
+<li><a
+href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2015/muth/Makefile">Makefile</a>
+- winner Makefile</li>
+<li><a
+href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2015/muth/prog.orig.c">prog.orig.c</a>
+- original source</li>
+<li><a
+href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2015/muth/try.sh">try.sh</a>
+- how to run</li>
+<li><a
+href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2015/muth/machine_beaver_4_2.h">machine_beaver_4_2.h</a>
+- cpp macros</li>
+<li><a
+href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2015/muth/machine_champ_2_4.h">machine_champ_2_4.h</a>
+- cpp macros</li>
+<li><a
+href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2015/muth/machine_chaos_5_2.h">machine_chaos_5_2.h</a>
+- cpp macros</li>
+<li><a
+href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2015/muth/machine_cmplx_5_2.h">machine_cmplx_5_2.h</a>
+- cpp macros</li>
+<li><a
+href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2015/muth/machine_count_5_2.h">machine_count_5_2.h</a>
+- cpp macros</li>
+<li><a
+href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2015/muth/machine_gcd.h">machine_gcd.h</a>
+- cpp macros</li>
+<li><a
+href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2015/muth/machine_great_3_2.h">machine_great_3_2.h</a>
+- cpp macros</li>
+<li><a
+href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2015/muth/machine_ioccc.h">machine_ioccc.h</a>
+- cpp macros</li>
+<li><a
+href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2015/muth/machine_nop.h">machine_nop.h</a>
+- cpp macros</li>
+<li><a
+href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2015/muth/machine_ru_2_4.h">machine_ru_2_4.h</a>
+- cpp macros</li>
+<li><a
+href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2015/muth/machine_times2.h">machine_times2.h</a>
+- cpp macros</li>
+<li><a
+href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2015/muth/tape_15_50.h">tape_15_50.h</a>
+- cpp macros</li>
+<li><a
+href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2015/muth/tape_77_55.h">tape_77_55.h</a>
+- cpp macros</li>
+<li><a
+href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2015/muth/tape_empty.h">tape_empty.h</a>
+- cpp macros</li>
+<li><a
+href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2015/muth/tape_five.h">tape_five.h</a>
+- cpp macros</li>
+<li><a href="2015_muth.tar.bz2">2015_muth.tar.bz2</a> - download winning
+source</li>
+</ul>
+<h2 id="secondary-files">Secondary files</h2>
+<ul>
+<li><a
+href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2015/muth/.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/2015/muth/.winner.json">.winner.json</a>
+- description of winner in JSON</li>
+<li><a
+href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2015/muth/README.md">README.md</a>
+- markdown source for index.html</li>
+</ul>
+
+<!-- END: next line ends content generated by: bin/gen-inventory.sh -->
+<!-- START: this line starts content from: inc/after-content.default.html -->
+
+<!-- END: this line ends content from: inc/after-content.default.html -->
+<!-- START: this line starts content from: inc/end-rightcolumn.default.html -->
+
+  </div>
+
+<!-- END: this line ends content from: inc/end-rightcolumn.default.html -->
+<!-- START: this line starts content from: inc/end-row.default.html -->
+
+</div>
+
+<!-- END: this line ends content from: inc/end-row.default.html -->
+<!-- START: this line starts content from: inc/footer.default.html -->
+
+<div class="footer">
+  <hr>
+  <h2>Coda</h2>
+  <p><a href="https://validator.w3.org/nu/?doc=https%3A%2F%2Fioccc-src.github.io%2Ftemp-test-ioccc%2F2015%2Fmuth%2Findex.html">Nu HTML check this web page</a></p>
+  <p><a href="#top">Jump to top</a> <a href="#content">Jump to Content</a> <a href="#inventory">Jump to Inventory</a></p>
+</div>
+
+<!-- END: this line ends content from: inc/footer.default.html -->
+<!-- START: this line starts content from: inc/bottom.default.html -->
 
 </body>
 </html>
+
+<!-- END: this line ends content from: inc/bottom.default.html -->