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.

tmp/manifest.csv

@@ -920,6 +920,8 @@
 1993,plummer,Makefile,30,true,makefile,true,winner Makefile
 1993,plummer,plummer.alt.c,40,true,c,true,alternative source
 1993,plummer,plummer.orig.c,50,false,c,true,original source
+1993,plummer,try.alt.sh,100,true,shellscript,true,how to run alternative code
+1993,plummer,try.sh,100,true,shellscript,true,how to run
 1993,plummer,1993_plummer.tar.bz2,300,false,tbz2,false,download winning source
 1993,plummer,README.md,4294967295,true,markdown,true,markdown source for index.html
 1993,plummer,.gitignore,4294967295,true,gitignore,true,list of files that should not be committed under git
@@ -989,6 +991,9 @@
 1994,horton,horton.alt.c,40,true,c,true,alternative source
 1994,horton,horton.orig.c,50,false,c,true,original source
 1994,horton,gtface.c,100,true,c,true,gtface source code
+1994,horton,try.alt.sh,100,true,shellscript,true,how to run alternative code
+1994,horton,try.sh,100,true,shellscript,true,how to run
+1994,horton,login_sept92-pp28-31.pdf,125,true,pdf,false,login article on graphics for dumb terminals
 1994,horton,gtface.data,150,true,text,true,data for gtfsace
 1994,horton,1994_horton.tar.bz2,300,false,tbz2,false,download winning source
 1994,horton,README.md,4294967295,true,markdown,true,markdown source for index.html
@@ -999,6 +1004,7 @@
 1994,imc,imc.c,20,true,c,true,winning source
 1994,imc,Makefile,30,true,makefile,true,winner Makefile
 1994,imc,imc.orig.c,50,false,c,true,original source
+1994,imc,try.sh,100,true,shellscript,true,how to run
 1994,imc,1994_imc.tar.bz2,300,false,tbz2,false,download winning source
 1994,imc,README.md,4294967295,true,markdown,true,markdown source for index.html
 1994,imc,.gitignore,4294967295,true,gitignore,true,list of files that should not be committed under git
@@ -1008,6 +1014,7 @@
 1994,ldb,ldb.c,20,true,c,true,winning source
 1994,ldb,Makefile,30,true,makefile,true,winner Makefile
 1994,ldb,ldb.orig.c,50,false,c,true,original source
+1994,ldb,try.sh,100,true,shellscript,true,how to run
 1994,ldb,1994_ldb.tar.bz2,300,false,tbz2,false,download winning source
 1994,ldb,README.md,4294967295,true,markdown,true,markdown source for index.html
 1994,ldb,.gitignore,4294967295,true,gitignore,true,list of files that should not be committed under git
@@ -1019,6 +1026,9 @@
 1994,schnitzi,schnitzi.alt2.c,40,true,c,true,alternate alternative source
 1994,schnitzi,schnitzi.alt.c,40,true,c,true,alternative source
 1994,schnitzi,schnitzi.orig.c,50,true,c,true,original source
+1994,schnitzi,try.alt.sh,100,true,shellscript,true,how to run alternative code
+1994,schnitzi,try.sh,100,true,shellscript,true,how to run
+1994,schnitzi,try.txt,100,true,text,true,input data for try.sh
 1994,schnitzi,1994_schnitzi.tar.bz2,300,false,tbz2,false,download winning source
 1994,schnitzi,README.md,4294967295,true,markdown,true,markdown source for index.html
 1994,schnitzi,.gitignore,4294967295,true,gitignore,true,list of files that should not be committed under git
@@ -1039,6 +1049,7 @@
 1994,smr,smr.c,20,true,c,true,winning source
 1994,smr,Makefile,30,true,makefile,true,winner Makefile
 1994,smr,smr.orig.c,50,true,c,true,original source
+1994,smr,try.sh,100,true,shellscript,true,how to run
 1994,smr,1994_smr.tar.bz2,300,false,tbz2,false,download winning source
 1994,smr,README.md,4294967295,true,markdown,true,markdown source for index.html
 1994,smr,.gitignore,4294967295,true,gitignore,true,list of files that should not be committed under git
@@ -1049,6 +1060,10 @@
 1994,tvr,Makefile,30,true,makefile,true,winner Makefile
 1994,tvr,tvr.alt.c,40,true,c,true,alternative source
 1994,tvr,tvr.orig.c,50,true,c,true,original source
+1994,tvr,try.alt.bw.sh,100,true,shellscript,true,demonstrate alt code in black and white mode
+1994,tvr,try.alt.color.sh,100,true,shellscript,true,demonstrate alt code in colour mode
+1994,tvr,try.bw.sh,100,true,shellscript,true,demonstrate code in black and white mode
+1994,tvr,try.color.sh,100,true,shellscript,true,demonstrate alt code in colour mode
 1994,tvr,tvr.bw,150,true,text,true,black and white
 1994,tvr,tvr.color,150,true,text,true,RGB values
 1994,tvr,1994_tvr.tar.bz2,300,false,tbz2,false,download winning source
@@ -1060,6 +1075,8 @@
 1994,weisberg,weisberg.c,20,true,c,true,winning source
 1994,weisberg,Makefile,30,true,makefile,true,winner Makefile
 1994,weisberg,weisberg.orig.c,50,true,c,true,original source
+1994,weisberg,primes.sh,100,true,shellscript,true,feed primes to the program
+1994,weisberg,try.sh,100,true,shellscript,true,how to run
 1994,weisberg,1994_weisberg.tar.bz2,300,false,tbz2,false,download winning source
 1994,weisberg,README.md,4294967295,true,markdown,true,markdown source for index.html
 1994,weisberg,.gitignore,4294967295,true,gitignore,true,list of files that should not be committed under git

tmp/path_list.found.txt

@@ -834,6 +834,8 @@
 1993/plummer/plummer.alt.c
 1993/plummer/plummer.c
 1993/plummer/plummer.orig.c
+1993/plummer/try.alt.sh
+1993/plummer/try.sh
 1993/rince/.gitignore
 1993/rince/.path
 1993/rince/.winner.json
@@ -897,6 +899,9 @@
 1994/horton/horton.c
 1994/horton/horton.orig.c
 1994/horton/index.html
+1994/horton/login_sept92-pp28-31.pdf
+1994/horton/try.alt.sh
+1994/horton/try.sh
 1994/imc/.gitignore
 1994/imc/.path
 1994/imc/.winner.json
@@ -905,6 +910,7 @@
 1994/imc/imc.c
 1994/imc/imc.orig.c
 1994/imc/index.html
+1994/imc/try.sh
 1994/ldb/.gitignore
 1994/ldb/.path
 1994/ldb/.winner.json
@@ -913,6 +919,7 @@
 1994/ldb/index.html
 1994/ldb/ldb.c
 1994/ldb/ldb.orig.c
+1994/ldb/try.sh
 1994/schnitzi/.gitignore
 1994/schnitzi/.path
 1994/schnitzi/.winner.json
@@ -923,6 +930,9 @@
 1994/schnitzi/schnitzi.alt2.c
 1994/schnitzi/schnitzi.c
 1994/schnitzi/schnitzi.orig.c
+1994/schnitzi/try.alt.sh
+1994/schnitzi/try.sh
+1994/schnitzi/try.txt
 1994/shapiro/.gitignore
 1994/shapiro/.path
 1994/shapiro/.winner.json
@@ -940,12 +950,17 @@
 1994/smr/index.html
 1994/smr/smr.c
 1994/smr/smr.orig.c
+1994/smr/try.sh
 1994/tvr/.gitignore
 1994/tvr/.path
 1994/tvr/.winner.json
 1994/tvr/Makefile
 1994/tvr/README.md
 1994/tvr/index.html
+1994/tvr/try.alt.bw.sh
+1994/tvr/try.alt.color.sh
+1994/tvr/try.bw.sh
+1994/tvr/try.color.sh
 1994/tvr/tvr.alt.c
 1994/tvr/tvr.bw
 1994/tvr/tvr.c
@@ -957,6 +972,8 @@
 1994/weisberg/Makefile
 1994/weisberg/README.md
 1994/weisberg/index.html
+1994/weisberg/primes.sh
+1994/weisberg/try.sh
 1994/weisberg/weisberg.c
 1994/weisberg/weisberg.orig.c
 1994/westley/.gitignore

tmp/path_list.manifest.txt

@@ -924,6 +924,8 @@
 1993/plummer/plummer.alt.c
 1993/plummer/plummer.c
 1993/plummer/plummer.orig.c
+1993/plummer/try.alt.sh
+1993/plummer/try.sh
 1993/rince/.gitignore
 1993/rince/.path
 1993/rince/.winner.json
@@ -994,6 +996,9 @@
 1994/horton/horton.c
 1994/horton/horton.orig.c
 1994/horton/index.html
+1994/horton/login_sept92-pp28-31.pdf
+1994/horton/try.alt.sh
+1994/horton/try.sh
 1994/imc/.gitignore
 1994/imc/.path
 1994/imc/.winner.json
@@ -1003,6 +1008,7 @@
 1994/imc/imc.c
 1994/imc/imc.orig.c
 1994/imc/index.html
+1994/imc/try.sh
 1994/ldb/.gitignore
 1994/ldb/.path
 1994/ldb/.winner.json
@@ -1012,6 +1018,7 @@
 1994/ldb/index.html
 1994/ldb/ldb.c
 1994/ldb/ldb.orig.c
+1994/ldb/try.sh
 1994/schnitzi/.gitignore
 1994/schnitzi/.path
 1994/schnitzi/.winner.json
@@ -1023,6 +1030,9 @@
 1994/schnitzi/schnitzi.alt2.c
 1994/schnitzi/schnitzi.c
 1994/schnitzi/schnitzi.orig.c
+1994/schnitzi/try.alt.sh
+1994/schnitzi/try.sh
+1994/schnitzi/try.txt
 1994/shapiro/.gitignore
 1994/shapiro/.path
 1994/shapiro/.winner.json
@@ -1043,6 +1053,7 @@
 1994/smr/index.html
 1994/smr/smr.c
 1994/smr/smr.orig.c
+1994/smr/try.sh
 1994/tvr/.gitignore
 1994/tvr/.path
 1994/tvr/.winner.json
@@ -1050,6 +1061,10 @@
 1994/tvr/Makefile
 1994/tvr/README.md
 1994/tvr/index.html
+1994/tvr/try.alt.bw.sh
+1994/tvr/try.alt.color.sh
+1994/tvr/try.bw.sh
+1994/tvr/try.color.sh
 1994/tvr/tvr.alt.c
 1994/tvr/tvr.bw
 1994/tvr/tvr.c
@@ -1062,6 +1077,8 @@
 1994/weisberg/Makefile
 1994/weisberg/README.md
 1994/weisberg/index.html
+1994/weisberg/primes.sh
+1994/weisberg/try.sh
 1994/weisberg/weisberg.c
 1994/weisberg/weisberg.orig.c
 1994/westley/.gitignore

tmp/path_list.required.txt

@@ -664,6 +664,8 @@
 1993/plummer/plummer.alt.c
 1993/plummer/plummer.c
 1993/plummer/plummer.orig.c
+1993/plummer/try.alt.sh
+1993/plummer/try.sh
 1993/rince/.gitignore
 1993/rince/.winner.json
 1993/rince/Makefile
@@ -715,18 +717,23 @@
 1994/horton/horton.alt.c
 1994/horton/horton.c
 1994/horton/horton.orig.c
+1994/horton/login_sept92-pp28-31.pdf
+1994/horton/try.alt.sh
+1994/horton/try.sh
 1994/imc/.gitignore
 1994/imc/.winner.json
 1994/imc/Makefile
 1994/imc/README.md
 1994/imc/imc.c
 1994/imc/imc.orig.c
+1994/imc/try.sh
 1994/ldb/.gitignore
 1994/ldb/.winner.json
 1994/ldb/Makefile
 1994/ldb/README.md
 1994/ldb/ldb.c
 1994/ldb/ldb.orig.c
+1994/ldb/try.sh
 1994/schnitzi/.gitignore
 1994/schnitzi/.winner.json
 1994/schnitzi/Makefile
@@ -735,6 +742,9 @@
 1994/schnitzi/schnitzi.alt2.c
 1994/schnitzi/schnitzi.c
 1994/schnitzi/schnitzi.orig.c
+1994/schnitzi/try.alt.sh
+1994/schnitzi/try.sh
+1994/schnitzi/try.txt
 1994/shapiro/.gitignore
 1994/shapiro/.winner.json
 1994/shapiro/Makefile
@@ -748,10 +758,15 @@
 1994/smr/README.md
 1994/smr/smr.c
 1994/smr/smr.orig.c
+1994/smr/try.sh
 1994/tvr/.gitignore
 1994/tvr/.winner.json
 1994/tvr/Makefile
 1994/tvr/README.md
+1994/tvr/try.alt.bw.sh
+1994/tvr/try.alt.color.sh
+1994/tvr/try.bw.sh
+1994/tvr/try.color.sh
 1994/tvr/tvr.alt.c
 1994/tvr/tvr.bw
 1994/tvr/tvr.c
@@ -761,6 +776,8 @@
 1994/weisberg/.winner.json
 1994/weisberg/Makefile
 1994/weisberg/README.md
+1994/weisberg/primes.sh
+1994/weisberg/try.sh
 1994/weisberg/weisberg.c
 1994/weisberg/weisberg.orig.c
 1994/westley/.gitignore