built year level index.html files

Added `bin/all-years.sh` to run a command over all years.

Added `bin/gen-year-index.sh` to build an `index.html`
for a given year.

Added support code to build an `index.html`
for a given year.

Added `make gen_year_index` to to level Makefile
and related rules.

Using the above, added `index.html` files for all IOCCC years.

Updated `bin/README.md` according to the above.

Improved comments in `bin/all-run.sh`.

Exported TOPDIR in all `bin/` tools that use TOPDIR.

Removed incorrect lines in `bin/quick-readme2index.sh`
usage message.

Improve -v 3 printed important variables messages,
in order that important variables are exported,
from all `bin/` tools.

Rebuild all HTML pages via `make www`.

bin/all-run.sh

@@ -21,11 +21,11 @@
 #
 # For example:
 #
-#	all-run.sh -v 3 -t readme2html -U https://www.ioccc.org bin/quick-readme2html.sh -v 1
+#	all-run.sh -v 3 -t readme2html -w https://www.ioccc.org bin/quick-readme2html.sh -v 1
 #
 # will run the tool bin/quick-readme2html.sh for each entry YYYY/dir as follows:
 #
-#	bin/quick-readme2html.sh -t readme2html -U https://www.ioccc.org YYYY/dir -v 1
+#	bin/quick-readme2html.sh -t readme2html -w https://www.ioccc.org YYYY/dir -v 1
 #
 # Only the "-D -t, -T, -p, -u, -w" option set are passed to the tool command line.
 # For all other special tool options, pass them as additional tool options (i.e., command line arguments
@@ -93,6 +93,7 @@ status="$?"
 if [[ $status -eq 0 ]]; then
     TOPDIR=$("$GIT_TOOL" rev-parse --show-toplevel)
 fi
+export TOPDIR
 export DOCROOT_SLASH="../../"
 export TAGLINE="unspecified"
 export MD2HTML_SH="bin/md2html.sh"
@@ -128,8 +129,9 @@ export USAGE="usage: $0 [-h] [-v level] [-V] [-d topdir] [-D docroot/] [-n] [-N]
 	-N		do not process anything, just parse arguments (def: process something)
 
 	-t tagline	string to write about the tool that formed the markdown content (def: $TAGLINE)
-			NOTE: 'pandoc_opts' may be enclosed within, but may NOT contain an internal single-quote or double-quote.
+			NOTE: The '-t tagline' is passed as leading options on tool command lines.
 	-T md2html.sh	run 'markdown to html tool' to convert markdown into HTML (def: $MD2HTML_SH)
+			NOTE: The '-T md2html.sh' is passed as leading options on tool command lines.
 
 	-p tool		run 'pandoc wrapper tool' (not pandoc path) during HTML phase number 21 (def: use $PANDOC_WRAPPER)
 
@@ -142,7 +144,7 @@ export USAGE="usage: $0 [-h] [-v level] [-V] [-d topdir] [-D docroot/] [-n] [-N]
 	tool		the tool to run over all entries
 	[more_options]	additional tool command line options to use before the YYYY/dir argument
 
-NOTE: Any '-t tagline', '-T md2html.sh', '-p tool', '-P pandoc_opts', '-u repo_url', '-U top_url'
+NOTE: Any '-D docroot/', '-t tagline', '-T md2html.sh', '-p tool', '-u repo_url', '-w site_url'
       are passed to the 'tool' at the beginning of the command line, and
       before any optional 'more_options' and before the final YYYY/dir argument.
 
@@ -376,7 +378,6 @@ if [[ $V_FLAG -ge 3 ]]; then
     echo "$0: debug[3]: V_FLAG=$V_FLAG" 1>&2
     echo "$0: debug[3]: GIT_TOOL=$GIT_TOOL" 1>&2
     echo "$0: debug[3]: TOPDIR=$TOPDIR" 1>&2
-    echo "$0: debug[3]: TOP_FILE=$TOP_FILE" 1>&2
     echo "$0: debug[3]: DOCROOT_SLASH=$DOCROOT_SLASH" 1>&2
     echo "$0: debug[3]: TAGLINE=$TAGLINE" 1>&2
     echo "$0: debug[3]: MD2HTML_SH=$MD2HTML_SH" 1>&2
@@ -391,6 +392,7 @@ if [[ $V_FLAG -ge 3 ]]; then
 	echo "$0: debug[3]: TOOL_OPTION[$index]=${TOOL_OPTION[$index]}" 1>&2
     done
     echo "$0: debug[3]: REPO_NAME=$REPO_NAME" 1>&2
+    echo "$0: debug[3]: TOP_FILE=$TOP_FILE" 1>&2
 fi
 
 # -N stops early before any processing is performed