add next/submit.html and improve FAQ and other refs to entering the I…

…OCCC

Added a new `next/submit.html` to move the "how to submit" form "in-line"
of the top FAQ entry into a new page managed by `next/submit.md`.
Thus, `next/submit.html` is a parallel to `next/register.html`
and `next/submit.md` is a parallel to `next/register.md`.

Changed the FAQ "faq.html#submit" and into "faq.html#enter".

Added individual tags for the steps in FAQ0.0.

Moved "faq.html#register" down to FAQ 0.0 step 2.

Added "faq.html#submit" for FAQ 0.0 step 5,
however elsewhere often "next/submit.html" is used.

Changed references for "faq.html#upload" to "next/submit.html".

We made a number of changes to the following markdown files to reflect the above:

- `about.md`
- `faq.md`
- `index.md`
- `markdown.md`
- `next/README.md`
- `next/README.md`
- `next/guidelines.md`
- `next/register.md`
- `next/rules.md`
- `nojs-menu.md`
- `status.md`

as well as these files:

- `bin/gen-top-html.sh`
- `bin/md2html.cfg`

and added:

- `next/submit.html`
- `next/submit.md`

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

TODO: Add images about the mailing list to `next/register.md`.  See the line:

```
XXX - **put images and other details about joining the mailing list here** - XXX
```

about.html

@@ -442,7 +442,7 @@ <h1 id="about-the-international-obfuscated-c-code-contest-ioccc">About the Inter
 FAQ on “<a href="faq.html#website_history">history of the IOCCC website</a>”
 for more information the background of the IOCCC.</p>
 <p>See the
-FAQ on “<a href="faq.html#submit">entering the IOCCC</a>”
+FAQ on “<a href="faq.html#enter">entering the IOCCC</a>”
 for information on how to enter and submit to the IOCCC.</p>
 <p>If you are still confused, consider the nature of
 the <a href="next/rules.html">IOCCC Rules</a> and of the <a href="next/guidelines.html">IOCCC

about.md

@@ -19,7 +19,7 @@ FAQ on "[history of the IOCCC website](faq.html#website_history)"
 for more information the background of the IOCCC.
 
 See the
-FAQ on "[entering the IOCCC](faq.html#submit)"
+FAQ on "[entering the IOCCC](faq.html#enter)"
 for information on how to enter and submit to the IOCCC.
 
 If you are still confused, consider the nature of

bin/gen-top-html.sh

@@ -150,6 +150,7 @@ TOP_MD_SET+=("next/README")
 TOP_MD_SET+=("next/guidelines")
 TOP_MD_SET+=("next/register")
 TOP_MD_SET+=("next/rules")
+TOP_MD_SET+=("next/submit")
 TOP_MD_SET+=("nojs-menu")
 TOP_MD_SET+=("status")
 TOP_MD_SET+=("thanks-for-help")

bin/md2html.cfg

@@ -357,6 +357,22 @@ next/README.md
 	-D
 	../
 
+next/guidelines.md
+	-H
+	navbar=empty
+	-o
+	bin/subst.default.sh
+	-s
+        TITLE=The International Obfuscated C Code Contest
+	-s
+	DESCRIPTION=IOCCC Guidelines
+	-s
+	KEYWORDS=IOCCC, guidelines, Guidelines
+	-s
+	HEADER_2=IOCCC Guidelines
+	-D
+	../
+
 next/register.md
 	-H
 	navbar=empty
@@ -389,19 +405,19 @@ next/rules.md
 	-D
 	../
 
-next/guidelines.md
+next/submit.md
 	-H
 	navbar=empty
 	-o
 	bin/subst.default.sh
 	-s
         TITLE=The International Obfuscated C Code Contest
 	-s
-	DESCRIPTION=IOCCC Guidelines
+	DESCRIPTION=How to upload your submission to the IOCCC submit server
 	-s
-	KEYWORDS=IOCCC, guidelines, Guidelines
+	KEYWORDS=IOCCC, submit, submission, submit server
 	-s
-	HEADER_2=IOCCC Guidelines
+	HEADER_2=How to upload your submission to the IOCCC submit server
 	-D
 	../
 

faq.html

@@ -428,7 +428,7 @@ <h1 id="ioccc-faq-table-of-contents">IOCCC FAQ Table of Contents</h1>
 <p>This is FAQ version <strong>28.1.8 2024-12-07</strong>.</p>
 <h2 id="entering-the-ioccc-the-bare-minimum-you-need-to-know">0. <a href="#enter_questions">Entering the IOCCC: the bare minimum you need to know</a></h2>
 <ul>
-<li><strong>Q 0.0</strong>: <a class="normal" href="#submit">How can I enter the IOCCC?</a></li>
+<li><strong>Q 0.0</strong>: <a class="normal" href="#enter">How can I enter the IOCCC?</a></li>
 <li><strong>Q 0.1</strong>: <a class="normal" href="#mkiocccentry">What is the <code>mkiocccentry</code> tool, how do I obtain it and how do I use it?</a>
 <ul>
 <li><strong>Q 0.1.1</strong>: <a class="normal" href="#about_mkiocccentry">What is <code>mkiocccentry(1)</code> in simple terms?</a></li>
@@ -575,43 +575,53 @@ <h1 id="the-ioccc-faq">The IOCCC FAQ</h1>
 <h2 id="section-0-entering-the-ioccc-the-bare-minimum-you-need-to-know">Section 0: Entering the IOCCC: the bare minimum you need to know</h2>
 </div>
 <p>Jump to: <a href="#">top</a></p>
-<div id="submit">
-<div id="register">
+<div id="enter">
 <h3 id="q-0.0-how-can-i-enter-the-ioccc">Q 0.0: How can I enter the IOCCC?</h3>
 </div>
-</div>
 <p>To submit your code to the IOCCC, you <strong>MUST</strong> follow these steps:</p>
+<div id="step_0">
 <h4 id="verify-that-the-ioccc-is-pending-or-open-for-submissions">0. Verify that the IOCCC is pending or open for submissions</h4>
+</div>
 <p>First, check the <a href="status.html">current status of the IOCCC</a> see of the contest.
 You may <strong>only register for the IOCCC when the IOCCC is either <a href="status.html#pending">pending</a>
 or <a href="status.html#open">open</a></strong>.</p>
 <p>You may <strong>only submit your entries to the IOCCC when the IOCCC is <a href="status.html#open">open</a></strong>.</p>
 <p>See also the <a href="news.html#news">IOCCC news</a> for more information.</p>
+<div id="step_1">
 <h4 id="read-the-latest-ioccc-rules-and-review-the-ioccc-guidelines">1. Read the latest IOCCC rules and review the IOCCC guidelines</h4>
+</div>
 <p>Please pay close attention to the <a href="next/rules.html">official IOCCC rules</a>.</p>
 <p>You are also <strong>highly encouraged</strong> to review the
 <a href="next/guidelines.html">official IOCCC guidelines</a> as they contain important
 suggestions, useful hints, and IOCCC humor. :-)</p>
+<div id="step_2">
+<div id="register">
 <h4 id="register-for-the-ioccc">2. Register for the IOCCC</h4>
+</div>
+</div>
 <p><strong>IMPORTANT</strong>: You may <strong>only register for the IOCCC when the IOCCC is either <a href="status.html#pending">pending</a>
 or <a href="status.html#open">open</a></strong>. See <a href="status.html">current status of the IOCCC</a> for details.</p>
 <p>If the contest is <a href="status.html#pending">pending</a> or <a href="status.html#open">open</a>,
 then follow the directions on <strong><a href="next/register.html">How to register for the IOCCC</a></strong>.</p>
 <p>For those who are <a href="next/register.html">registered for the IOCCC</a>,
 once the contest is <a href="status.html#open">open</a> you will receive your own Email message
 containing your very own <strong>Username and Initial Password until the contest is <a href="#open">open</a></strong>.
-You will need these to be able to <a href="faq.html#upload">upload your submission</a> to the
+You will need these to be able to <a href="next/submit.html">upload your submission</a> to the
 <a href="https:/submit.ioccc.org">IOCCC submit server</a>.</p>
 <p>Please check the <a href="status.html">current status of the IOCCC</a> and
 visit the <a href="next/register.html">How to register for the IOCCC</a> for detailed instructions.</p>
+<div id="step_3">
 <h4 id="obtain-and-compile-the-latest-mkiocccentry-toolkit">3. Obtain and compile the latest mkiocccentry toolkit</h4>
+</div>
 <p>You <strong>MUST</strong> use the most recent version of the <code>mkiocccentry</code> toolkit. To help
 you, please see the
 FAQ on “<a href="#obtaining_mkiocccentry">how to obtain the most recent mkiocccentry</a>”
 and the
 FAQ on “<a href="#compiling_mkiocccentry">compiling mkiocccentry toolkit</a>”,
 for more details.</p>
+<div id="step_4">
 <h4 id="run-the-mkiocccentry-tool-to-form-your-submission-tarball">4. Run the mkiocccentry tool to form your submission tarball</h4>
+</div>
 <p>For more details on <code>mkiocccentry</code>, what it is, how to obtain it and how to use
 it, see the
 FAQ on “<a href="#mkiocccentry">mkiocccentry</a>”
@@ -653,94 +663,18 @@ <h4 id="run-the-mkiocccentry-tool-to-form-your-submission-tarball">4. Run the mk
 <p>If you choose to risk violating rules, be sure and explain your reason
 for doing so in your <code>remarks.md</code> file.</p>
 <p>See also <a href="next/rules.html#rule17">Rule 17</a>!</p>
-<div id="upload">
-<h4 id="upload-your-entry-to-the-ioccc-submit-server">5. Upload your entry to the IOCCC submit server</h4>
+<div id="step_5">
+<div id="submit">
+<h4 id="upload-your-submission-to-the-ioccc-submit-server">5. Upload your submission to the IOCCC submit server</h4>
 </div>
-<p><strong>IMPORTANT NOTE</strong>: The IOCCC <a href="https://submit.ioccc.org">submit server</a> is located at
-<a href="https://submit.ioccc.org">https://submit.ioccc.org</a> and ready for submissions
-<strong>ONLY WHEN THE CONTEST IS <a href="status.html#open">open</a></strong>. See <a href="status.html">current status of the IOCCC</a>
-for details.</p>
-<p><strong>IMPORTANT NOTE</strong>: The contest is <a href="status.html#closed">closed</a>, the
-<a href="https://submit.ioccc.org">https://submit.ioccc.org</a> may be offline.</p>
-<p>The following steps should be taken, in order to upload your <code>mkiocccentry</code> xz
-compressed tarball, to change the file (if you need to upload a different file
-or you have updated the submission), and to check the status of it after the
-contest closes:</p>
-<p>First, open the web page in your browser. It should look like this:
-With the login id and password already input, It should look something like
-this:</p>
-<p><img src="png/submit-server-login.png"
- alt="submit server login screen"
- width=710 height=562></p>
-<p>The login is the UUID you were provided when you registered for the IOCCC and
-the password is the initial password you were provided with. Click “Login”.
-Assuming everything is fine, it should look something like:</p>
-<p><img src="png/submit-server-first-login.png"
- alt="submit server password change required"
- width=710 height=808></p>
-<p>As you can see, you have to change your password. Put in your login (UUID
-username), your old (initial) password and a new password. For instance:</p>
-<p><img src="png/submit-server-change-passwd.png"
- alt="submit server changing password"
- width=710 height=808></p>
-<p>Click “Change Password”.</p>
-<p>Once this is done, you will have to log in again. Using the UUID login and the
-new password:</p>
-<p><img src="png/submit-server-passwd-changed.png"
- alt="submit server password changed"
- width=710 height=344></p>
-<p>.. click “Login”.</p>
-<p>Once you’ve logged in, you will see submit slots. Each slot is for one
-submission so if you update a submission, make sure you choose the right one so
-you do not overwrite the wrong one!</p>
-<p>Here is what it looks like without any uploads and no slot selected:</p>
-<p><img src="png/submit-server-slots.png"
- alt="submit server slots"
- width=710 height=806></p>
-<p>Select a slot and then select a file by clicking the button “Choose File”. After
-doing this, it should look something like:</p>
-<p><img src="png/submit-server-slot-file.png"
- alt="submit server slot and file selected"
- width=717 height=865></p>
-<p>If you need to change the file to upload, you can mouseover the file and click
-it. If you wait a moment it’ll show the current filename. It will look something
-like this:</p>
-<p><img src="png/submit-server-change-file.png"
- alt="submit server change file"
- width=717 height=865></p>
-<p>Once you’re certain you have selected the correct file, click “Submit”, below
-the file selection step.</p>
-<p>When it’s uploaded it should look something like this:</p>
-<p><img src="png/submit-server-submission-uploaded.png"
- alt="submit server submission uploaded"
- width=717 height=525></p>
-<p>Here you see the details, in particular:</p>
-<ul>
-<li>the status of the submission</li>
-<li>the filename, which will be in the correct format, assuming you used
-<code>mkiocccentry(1)</code> which is <strong>HIGHLY</strong> recommended so that you do not break <a href="next/rules.html#rule17">Rule
-17</a>!</li>
-<li>the file length, which <code>txzchk(1)</code> will also verify (the file itself and the
-tarball listing)</li>
-<li>the upload date</li>
-<li>the SHA256 hash of the file</li>
-</ul>
-<p>Now if you’re done, log out.</p>
-<p>After the submission deadline is reached, you can log in to check the status of
-your submissions. Here is what it will look like when the judges have verified
-that your tarball / submission has been validated (NOT judged), by <code>txzchk(1)</code>
-and <code>chkentry(1)</code>.:</p>
-<p><img src="png/submit-server-status-updated.png"
- alt="submit server status updated"
- width=717 height=217></p>
-<p>For details on <code>txzchk</code>, see the
-FAQ on “<a href="#txzchk">txzchk</a>”.</p>
-<p>For details on <code>chkentry</code>, see the
-FAQ on “<a href="#chkentry">chkentry</a>”.</p>
-<p>If you need more information on what <code>chkentry</code> checks, see the
-FAQ on the <a href="#info_json">“.info.json file</a>”
-and the
-FAQ on the “<a href="#auth_json">.auth.json file</a>”.</p>
+</div>
+<p><strong>IMPORTANT NOTE</strong>: The <a href="https://submit.ioccc.org">IOCCC submit server</a>
+is only ready for submissions
+<strong>ONLY WHEN THE CONTEST IS <a href="status.html#open">open</a></strong>.</p>
+<p>See <a href="status.html">current status of the IOCCC</a> for details on the contest status.
+<strong>IMPORTANT NOTE</strong>: When the contest is <a href="status.html#closed">closed</a>, the
+<a href="https://submit.ioccc.org">IOCCC submit server</a>
+may be offline and unreachable as a web site.</p>
 <p>Jump to: <a href="#">top</a></p>
 <div id="what_mkiocccentry">
 <div id="mkiocccentry">
@@ -779,7 +713,7 @@ <h4 id="q-0.1.1-what-is-mkiocccentry-in-simple-terms">Q 0.1.1: What is <code>mki
 FAQ on “<a href="#chkentry">chkentry</a>”
 for more information on these important tools, if you want more information.</p>
 <p>See the
-FAQ on “<a href="#submit">submitting to the IOCCC</a>”
+FAQ on “<a href="#submit">how to upload you submission</a>”
 for details on how to register for the IOCCC, the
 FAQ on “<a href="#obtaining_mkiocccentry">obtaining the latest mkiocccentry toolkit</a>”
 for details on obtaining the latest release, the
@@ -1073,7 +1007,7 @@ <h3 id="q-1.2-what-is-markdown-and-how-does-the-ioccc-use-it">Q 1.2: What is mar
 </div>
 </div>
 <p>The IOCCC makes extensive use of <a href="https://daringfireball.net/projects/markdown/">markdown</a>.
-For example, when <a href="#submit">submitting to the IOCCC</a>, we have people
+For example, when <a href="next/submit.html">submitting to the IOCCC</a>, we have people
 submit remarks about entry in markdown format. Every
 <a href="years.html">winning IOCCC entry</a> uses a <code>README.md</code> markdown file
 as the basis for forming the <code>index.html</code> web page for that entry.
@@ -2715,7 +2649,7 @@ <h3 id="q-3.8-how-can-i-find-my-author-handle">Q 3.8: How can I find my author h
 that follows the <em>author_handle</em>: line.</p>
 <p>If you are not someone who has won a previous IOCCC, you will be able to select
 a potential <em>author_handle</em> when you form your <em>submission</em> tarball (see
-FAQ on “<a href="#submit">how to submit</a>”
+FAQ on “<a href="#enter">how to enter the IOCCC</a>”
 ).</p>
 <p><strong>Helpful Hint</strong>: If an <em>author</em> clicks on their <em>author_handle:</em>
 line link, you will be taken to that author’s <code>author_handle.json</code> file.</p>