add next/register.html page, improve bin/gen-status.sh

Added a new `next/register.html` that is required by the mailing list server.
The `next/register.md` still contains a big **XXX - put more data here - XXX**
as a placeholder for information about the mailing list registration process.

Improved the status text for `faq.html`, `next/index.html` and `status.html`
via `faq.md`, `next/README.md` and `status.md`.  We also removed the
excessive links to IOCCC and instead use the term "contest" where applicable.

IMPORTANT CHANGE: Registration be available when the contest is both pending and open.

We made a number of changes to `faq.md`, `next/README.md` in an attempt to
reflect the above.

Changed `bin/gen-status.sh` VERSION from "1.7 2024-09-23"
to "1.8 2024-11-23".

Changed `bin/gen-top-html.sh` VERSION from "1.4.9 2024-08-11"
to "1.4.10 2024-11-23".

Perform `make www` and `make gen_status` to perform the above and test under macOS.

TODO: Change **XXX - put more data here - XXX** in `next/register.md` for information
      about how to join the mailing list.

bin/gen-status.sh

@@ -86,7 +86,7 @@ shopt -s globstar	# enable ** to match all files and zero or more directories an
 
 # set variables referenced in the usage message
 #
-export VERSION="1.7 2024-09-23"
+export VERSION="1.8 2024-11-23"
 NAME=$(basename "$0")
 export NAME
 export V_FLAG=0
@@ -824,37 +824,76 @@ if [[ $V_FLAG -ge 3 ]]; then
 fi
 
 
-# obtain contest_status if CONTEST_STATUS was not set in the arg
+# obtain the current contest status
+#
+export CURRENT_CONTEST_STATUS=""
+PATTERN='$..contest_status'
+CURRENT_CONTEST_STATUS=$("$JVAL_WRAPPER" -b -q "$STATUS_JSON" "$PATTERN")
+status="$?"
+if [[ $status -ne 0 || -z $CURRENT_CONTEST_STATUS ]]; then
+    echo "$0: ERROR: cannot determine current contest status from status.json: $STATUS_JSON" 1>&2
+    exit 1
+fi
+if [[ $V_FLAG -ge 3 ]]; then
+    echo "$0: debug[3]: Contest status from $STATUS_JSON: $CURRENT_CONTEST_STATUS" 1>&2
+fi
+
+# validate and normalize the current contest status from status.json
+#
+case "$CURRENT_CONTEST_STATUS" in
+pending) CURRENT_CONTEST_STATUS="pending"
+    ;;
+open) CURRENT_CONTEST_STATUS="open"
+    ;;
+judging) CURRENT_CONTEST_STATUS="judging"
+    ;;
+closed) CURRENT_CONTEST_STATUS="closed"
+    ;;
+*) echo "$0: ERROR: unexpected status from $status.json: $CURRENT_CONTEST_STATUS" 1>&2
+    echo 1>&2
+    echo "$USAGE" 1>&2
+    exit 1
+    ;;
+esac
+if [[ $V_FLAG -ge 1 ]]; then
+    echo "$0: debug[1]: Current contest status: $CURRENT_CONTEST_STATUS" 1>&2
+fi
+
+
+# set the contest status if CONTEST_STATUS was not set in the arg
 #
 if [[ -z $CONTEST_STATUS ]]; then
+    CONTEST_STATUS="$CURRENT_CONTEST_STATUS"
+fi
 
-    # obtain the contest_status from status.json
-    #
-    PATTERN='$..contest_status'
-    CONTEST_STATUS=$("$JVAL_WRAPPER" -b -q "$STATUS_JSON" "$PATTERN")
-    status="$?"
-    if [[ $status -ne 0 || -z $CONTEST_STATUS ]]; then
-	echo "$0: ERROR: cannot determine contest_status from status.json: $STATUS_JSON" 1>&2
-	exit 1
+
+# validate and normalize the contest status
+#
+case "$CONTEST_STATUS" in
+pending) CONTEST_STATUS="pending"
+    ;;
+open) CONTEST_STATUS="open"
+    ;;
+judging) CONTEST_STATUS="judging"
+    ;;
+closed) CONTEST_STATUS="closed"
+    ;;
+*) echo "$0: ERROR: unknown new contest status: $CONTEST_STATUS" 1>&2
+    echo 1>&2
+    echo "$USAGE" 1>&2
+    exit 1
+    ;;
+esac
+
+
+# report on any potential contest status change
+#
+if [[ $V_FLAG -ge 1 ]]; then
+    if [[ $CURRENT_CONTEST_STATUS != "$CONTEST_STATUS" ]]; then
+	echo "$0: debug[1]: Contest status will change from: $CURRENT_CONTEST_STATUS to: $CONTEST_STATUS" 1>&2
+    else
+	echo "$0: debug[1]: Contest status will not change from: $CONTEST_STATUS" 1>&2
     fi
-
-    # validate and normalize the contest_status from status.json
-    #
-    case "$CONTEST_STATUS" in
-    pending) CONTEST_STATUS="pending"
-	;;
-    open) CONTEST_STATUS="open"
-	;;
-    judging) CONTEST_STATUS="judging"
-	;;
-    closed) CONTEST_STATUS="closed"
-	;;
-    *) echo "$0: ERROR: unexpected status from $status.json: $CONTEST_STATUS" 1>&2
-	echo 1>&2
-	echo "$USAGE" 1>&2
-	exit 1
-	;;
-    esac
 fi
 
 

bin/gen-top-html.sh

@@ -106,7 +106,7 @@ shopt -s globstar	# enable ** to match all files and zero or more directories an
 
 # set variables referenced in the usage message
 #
-export VERSION="1.4.9 2024-08-11"
+export VERSION="1.4.10 2024-11-23"
 NAME=$(basename "$0")
 export NAME
 export V_FLAG=0
@@ -148,6 +148,7 @@ TOP_MD_SET+=("markdown")
 TOP_MD_SET+=("news")
 TOP_MD_SET+=("next/README")
 TOP_MD_SET+=("next/guidelines")
+TOP_MD_SET+=("next/register")
 TOP_MD_SET+=("next/rules")
 TOP_MD_SET+=("nojs-menu")
 TOP_MD_SET+=("status")

bin/md2html.cfg

@@ -357,6 +357,22 @@ next/README.md
 	-D
 	../
 
+next/register.md
+	-H
+	navbar=empty
+	-o
+	bin/subst.default.sh
+	-s
+        TITLE=The International Obfuscated C Code Contest
+	-s
+	DESCRIPTION=How to register for the IOCCC
+	-s
+	KEYWORDS=IOCCC, register, registration
+	-s
+	HEADER_2=How to register for the IOCCC
+	-D
+	../
+
 next/rules.md
 	-H
 	navbar=empty