From 1c5f14f3e065cb79ac6ffd03a192c9aa89201d7d Mon Sep 17 00:00:00 2001
From: Cody Boone Ferguson <53008573+xexyl@users.noreply.github.com>
Date: Mon, 10 Feb 2025 13:28:41 -0800
Subject: [PATCH] More updates to FAQ for mkiocccentry process

Missing steps were added and other things which have changed (fixed)
have also bee noted.

There was also a typo fix in the rules.
---
 faq.html        | 154 ++++++++++++++++++++++++++++++-----------------
 faq.md          | 155 ++++++++++++++++++++++++++++++------------------
 next/rules.html |   4 +-
 next/rules.md   |   4 +-
 4 files changed, 198 insertions(+), 119 deletions(-)

diff --git a/faq.html b/faq.html
index 6f12bcabc..689213674 100644
--- a/faq.html
+++ b/faq.html
@@ -425,7 +425,7 @@
 
 <!-- BEFORE: 1st line of markdown file: faq.md -->
 <h1 id="ioccc-faq-table-of-contents">IOCCC FAQ Table of Contents</h1>
-<p>This is FAQ version <strong>28.2.7 2025-02-09</strong>.</p>
+<p>This is FAQ version <strong>28.2.8 2025-02-10</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="#enter">How can I enter the IOCCC?</a></li>
@@ -1392,50 +1392,68 @@ Jump to: <a href="#">top</a>
 <div id="mkiocccentry_process">
 <h3 id="q-3.0-what-is-the-mkiocccentry1-process-and-what-sort-of-checks-does-it-perform">Q 3.0: What is the <code>mkiocccentry(1)</code> process and what sort of checks does it perform?</h3>
 </div>
-<p>The <code>mkiocccentry(1)</code> tool performs the following steps:</p>
+<p>In full, the <code>mkiocccentry(1)</code> tool performs the following steps:</p>
 <ol start="0" type="1">
-<li>Ask the user for a submission ID (see the <a href="quick-start.html">quick-start
-guide</a> for more details on how to obtain this).
+<li>Ask the user for a submission ID (see the <a href="next/register.html">how to register</a>
+for more details on how to obtain this and <a href="next/rules.html#rule17">Rule 17</a> for
+the importance of this).
 <ul>
-<li>If this is an invalid UUID (malformed), it is an error.</li>
+<li>If this is an invalid UUID (malformed), you will be asked to correct it
+until it is.</li>
 </ul></li>
-<li>Ask the user for the submission slot (the submission number; see <a href="next/rules.html#rule17">Rule
-17</a> for more details).
+<li>Ask the user for the submission slot (the submission number; see <a href="next/register.html">how to
+register</a> and <a href="next/rules.html#rule17">Rule 17</a> for more details).
 <ul>
-<li>If this is out of range it is an error (see <code>MAX_SUBMIT_SLOT</code> in
-<a href="https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h">limit_ioccc.h</a>).</li>
+<li>If this is out of range (see <code>MAX_SUBMIT_SLOT</code> in
+<a href="https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h">limit_ioccc.h</a>)
+and you will be asked to correct it until it is.</li>
+</ul></li>
+<li>Make the submission directory under <code>topdir</code> in the form of
+<code>workdir/submit.USERNAME-SLOT.TIMESTAMP</code> (the timestamp is calculated by
+<code>mkiocccentry(1)</code> so you do not have to worry about this).
+<ul>
+<li>If this directory already exists it is an error.</li>
 </ul></li>
 <li>Change to the <code>topdir</code>.</li>
-<li>Traverses the directory, creating lists of ignored
+<li>Traverse the directory, creating lists of ignored/forbidden
 files/directories/symlinks as well as a list directories to make and a list of
-files to copy to the submission directory.
+files to copy to the submission directory (and if (sub)directories are found
+with files, copy those files to their respective directory). Note the following:
 <ul>
 <li>If the depth is too deep it is an error (see <code>MAX_PATH_DEPTH</code> in
 <a href="https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h">limit_ioccc.h</a>).</li>
-<li>If there are too many directories it is an error (see <code>MAX_DIR_COUNT</code> in
+<li>If there are too many extra directories (total count not including the
+submission directory itself, unrelated to <code>MAX_PATH_DEPTH</code> above) it is an
+error (see <code>MAX_EXTRA_DIR_COUNT</code> in
 <a href="https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h">limit_ioccc.h</a>).</li>
-<li>If a filename or directory name is not a sane relative path, not allowed
-or will not be added for some other reason, it will be added to a relevant list to show to
-the user later, to let them know it is ignored. By <code>relative</code> we mean it
-must not start with <code>/</code> and by <code>sane</code> we mean that each component must match
-the regexp: <code>^[0-9A-Za-z]+[0-9A-Za-z_+.-]*$</code>.</li>
-<li>If the path length (i.e. the entire length of the path from the <code>topdir</code>)
-is too long it is an error (see <code>MAX_PATH_LEN</code> in
-<a href="https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h">limit_ioccc.h</a>).</li>
-<li>If a filename is too long it is an error (see <code>MAX_FILENAME_LEN</code> in
-<a href="https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h">limit_ioccc.h</a>).</li>
-<li>If there is an unknown error it is an error :-)</li>
-<li>If a path is NULL it is an error.</li>
-<li>If a path is an empty string it is an error.</li>
 <li>If the max path length is &lt;= 0 it is an error (and a bug).</li>
 <li>If the max depth is &lt;= 0 it is an error (and a bug).</li>
 <li>If the max filename length is &lt;= 0 it is an error (and a bug).</li>
-<li>If a directory is not readable it is an error.</li>
+<li>If a path is NULL it is an error.</li>
+<li>If a path is an empty string it is an error.</li>
+<li>If the path length (i.e. <code>strlen(path)</code> where path starts after the
+initial <code>./</code> of the path in the <code>topdir</code>) is too long it is an error (see <code>MAX_PATH_LEN</code> in
+<a href="https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h">limit_ioccc.h</a>).</li>
+<li>If a filename (last component of the path) is too long it is an error (see <code>MAX_FILENAME_LEN</code> in
+<a href="https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h">limit_ioccc.h</a>).</li>
+<li>If a filename or directory name is not a sane relative path, not allowed
+or will not be added for some other reason, it will be added to a relevant list to show to
+the user later, to let them know it will not be added to the submission. By <code>relative</code> we mean it
+must not start with <code>/</code> (which shouldn’t happen even if you give an absolute
+path) and by <code>sane</code> we mean that each component must match the regexp: <code>^[0-9A-Za-z]+[0-9A-Za-z_+.-]*$</code>.</li>
+<li>If a directory is unreadable it is an error.</li>
+<li>If a directory causes a cycle in the tree it is an error.</li>
+<li>If <code>stat(2)</code> on the path fails it is an error.</li>
 <li>If <code>prog.c</code>, <code>Makefile</code> or <code>remarks.md</code> is/are not found it is an error.</li>
 <li>If too many files that are not <code>prog.c</code>, <code>Makefile</code>, <code>remarks.md</code>,
 <code>try.sh</code>, <code>prog.alt.c</code> or <code>try.alt.sh</code> are found, it is an error (see
 <code>MAX_EXTRA_FILE_COUNT</code> in
 <a href="https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h">limit_ioccc.h</a>).</li>
+<li>Symlinks are not allowed but it is not an error (they will be added to a
+list and ignored).</li>
+<li>If any file type other than a regular file, a directory or a symlink is
+encountered it is an error.</li>
+<li>If there is an unknown error it is an error :-)</li>
 </ul></li>
 <li>Show each list to the user, asking if this is okay. The lists include:
 <ul>
@@ -1451,8 +1469,8 @@ with <code>.</code>.</li>
 <li>Directories to be made.</li>
 <li>Required files (<code>prog.c</code>, <code>Makefile</code> and <code>remarks.md</code>) to be copied.</li>
 <li>Non-required files to be copied.</li>
-<li>The user is asked to verify each list, including the list of files to be
-added, and if the user says it is not OK the program will abort.</li>
+<li>The user is asked to verify each list, including the lists of directories
+and files to be made/copied, and if the user says it is not OK the program will abort.</li>
 </ul></li>
 <li>Make any directories if necessary (under
 <code>workdir/submit.USERNAME-SLOT.TIMESTAMP</code> i.e. the submission directory).
@@ -1463,21 +1481,25 @@ added, and if the user says it is not OK the program will abort.</li>
 <li>The non-ignored files are copied to their respective directories under the
 submission directory.
 <ul>
-<li><code>try.sh</code> and <code>try.alt.sh</code> MUST be and are copied as mode <code>0555</code>.</li>
+<li><code>try.sh</code> and <code>try.alt.sh</code> <strong>MUST</strong> be and are copied as mode <code>0555</code>.</li>
 <li>All other files <strong>MUST</strong> be and are copied as mode <code>0444</code>.</li>
-<li>Anything else is an error and <code>txzchk(1)</code> will flag this.</li>
+<li>Anything else will be flagged by <code>txzchk(1)</code>.</li>
 </ul></li>
 <li><code>cd submit.USERNAME-SLOT.TIMESTAMP</code> (i.e. switch to submission directory).</li>
 <li><code>make -f Makefile clobber</code>.
 <ul>
-<li>If this fails it is not an error but you are warned about it (even so, see <a href="next/rules.html#rule20">Rule 20</a>).</li>
+<li>If this fails it is not an error but you are warned about it (it is an error only if the <code>Makefile</code>
+does not exist); even so, see <a href="next/rules.html#rule20">Rule 20</a>.</li>
 </ul></li>
 <li>Traverse the new tree from <code>.</code> with additional steps from (4).
 <ul>
 <li>If any file has an ignored directory name in it, it is an error.</li>
 <li>If a symlink is found it is an error.</li>
+<li>If any file type other than a directory or regular file exists it is an
+error.</li>
 <li>If a forbidden filename exists it is an error.</li>
-<li>If any file or directory starts with <code>/</code> or is not POSIX plus + safe chars only it is an error.</li>
+<li>If any file or directory starts with <code>/</code> or is not POSIX plus + safe chars
+only (see (4) above) it is an error.</li>
 <li>If the depth is too deep it is an error.</li>
 <li>If <code>prog.c</code>, <code>Makefile</code> or <code>remarks.md</code> are missing (or not readable
 regular files) it is an error.</li>
@@ -1493,11 +1515,13 @@ empty file it is an error but otherwise you may override any warnings
 <li><code>check_remarks_md()</code> will be run on your <code>remarks.m</code>; if it is not a
 regular readable file or it is empty it is an error. Otherwise it will
 proceed. Note it does not check that there is any text in the file, just
-that the file size is not 0.</li>
-<li>If any other error condition in step (4) occurs it is also an error.</li>
+that the file size is not 0, and having a <code>remarks.md</code> that is not size 0
+but has no content is violating <a href="next/rules.html#rule17">Rule 17</a> and <a href="next/rules.html#rule19">Rule
+19</a>.</li>
+<li>If any other error condition from step (4) occurs it is also an error.</li>
 </ul></li>
-<li>Report on files that were copied in (3) and directories made in (3) but are
-now gone: asking the user to verify.</li>
+<li>Report on any directories that were made and files that were copied in (7)
+but are now gone: asking the user to verify.</li>
 <li>Present the list of non-dot files that remain and ask the user to confirm.</li>
 <li>Ask the user for a submission title.</li>
 <li>Ask the user for a one line abstract of the submission.</li>
@@ -1505,36 +1529,49 @@ now gone: asking the user to verify.</li>
 questions (see below for more information on what kind of questions).</li>
 <li>Show the output of <code>ls -lakR .</code>, asking the user to confirm that the listing
 is okay.</li>
+<li>Create <code>.info.json</code> and run <code>chkentry(1)</code> on it.
+<ul>
+<li>If <code>chkentry(1)</code> fails to validate the file make sure that you have
+obtained and compiled the latest version of all the tools and you either are
+in the repo’s directory, you pass the options to give the path to the tools
+or you have installed the latest tools!</li>
+</ul></li>
+<li>Create <code>.auth.json</code> and run <code>chkentry(1)</code> on it.
+<ul>
+<li>If <code>chkentry(1)</code> fails to validate the file make sure that you have
+obtained and compiled the latest version of all the tools and you either are
+in the repo’s directory, you pass the options to give the path to the tools
+or you have installed the latest tools!</li>
+</ul></li>
 <li>Create the tarball.</li>
 <li>Run <code>txzchk(1)</code> on the tarball.</li>
 </ol>
-<p>If any of the steps fail or if the user says something is not okay, it aborts.</p>
-<p>Some of the checks that are made:</p>
+<p>If any of the steps fail or if the user says something is not okay, it aborts.
+Some of the other checks that are made:</p>
 <ul>
-<li>If the files do not exist, are not regular files or cannot be read.</li>
 <li>If <code>prog.c</code> violates <a href="next/rules.html#rule2">Rule 2</a> (see
 <a href="https://github.com/ioccc-src/mkiocccentry/blob/master/iocccsize.c">iocccsize.c</a>).</li>
-<li>If <code>prog.c</code> is empty.</li>
-<li>If <code>prog.c</code> has any high bit char (see
-<a href="https://github.com/ioccc-src/mkiocccentry/blob/master/iocccsize.c">iocccsize.c</a>).</li>
-<li>If <code>prog.c</code> has any NUL char (see
-<a href="https://github.com/ioccc-src/mkiocccentry/blob/master/iocccsize.c">iocccsize.c</a>).</li>
+<li>If <code>prog.c</code> is empty (see <a href="next/rules.html#rule1">Rule 1</a> and the
+<a href="next/guidelines.html">Guidelines</a>).</li>
+<li>If <code>prog.c</code> has any NUL (<code>\0</code>) char (see
+<a href="https://github.com/ioccc-src/mkiocccentry/blob/master/soup/rule_count.c">rule_count.c</a>).</li>
 <li>If <code>prog.c</code> has any unknown or invalid trigraph (see
-<a href="https://github.com/ioccc-src/mkiocccentry/blob/master/iocccsize.c">iocccsize.c</a>).</li>
+<a href="https://github.com/ioccc-src/mkiocccentry/blob/master/soup/rule_count.c">rule_count.c</a>).</li>
 <li>If <code>prog.c</code> triggers a word buffer overflow (see
-<a href="https://github.com/ioccc-src/mkiocccentry/blob/master/iocccsize.c">iocccsize.c</a>).</li>
+<a href="https://github.com/ioccc-src/mkiocccentry/blob/master/soup/rule_count.c">rule_count.c</a>).</li>
 <li>If <code>prog.c</code> triggers an <code>ungetc(3)</code> error (see
-<a href="https://github.com/ioccc-src/mkiocccentry/blob/master/iocccsize.c">iocccsize.c</a>).</li>
+<a href="https://github.com/ioccc-src/mkiocccentry/blob/master/soup/rule_count.c">rule_count.c</a>).</li>
 <li>If the first rule in the <code>Makefile</code> is not <code>all</code>.</li>
 <li>If the <code>Makefile</code> does not have a <code>clean</code> rule.</li>
 <li>If the <code>Makefile</code> does not have a <code>clobber</code> rule.</li>
 <li>If the <code>Makefile</code> does not have a <code>try</code> rule.</li>
 </ul>
-<p>If your <code>Makefile</code> is empty or <code>remarks.md</code> is empty it is an error and you will
-have to fix it.</p>
-<p>Conditions that one must correct, and which <code>mkiocccentry(1)</code> will prompt until
+<p>Conditions that one <strong>MUST</strong> correct, and which <code>mkiocccentry(1)</code> will prompt until
 they are correct, are:</p>
 <ul>
+<li>Your <em>contest ID</em> is invalidly formed.</li>
+<li>Your <em>submit slot</em> is &lt; 0 or &gt; <code>MAX_SUBMIT_SLOT</code> (see
+<a href="https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h">limit_ioccc.h</a>).</li>
 <li>Your <em>title</em> is not in the range of 1 through <code>MAX_TITLE_LEN</code> chars (see
 <a href="https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h">limit_ioccc.h</a>).</li>
 <li>Your <em>title</em> does not match the regexp <code>^[0-9a-z][0-9a-z._+-]*$</code>.</li>
@@ -1545,8 +1582,7 @@ they are correct, are:</p>
 <li>An author <em>name</em> is not 1 through <code>MAX_NAME_LEN</code> chars (see
 <a href="https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h">limit_ioccc.h</a>).</li>
 <li>Duplicate author <em>name</em>.</li>
-<li><em>Country code</em> is invalid (not ISO 3166-1 2 character
-codes).</li>
+<li><em>Country code</em> is invalid (i.e. it is not a ISO 3166-1 2 character code).</li>
 <li>An <em>email</em>, if provided, is not in the format of <code>x@y</code> or
 if <code>x</code> or <code>y</code> contain a <code>@</code>, are empty or if the total length is longer than
 <code>MAX_EMAIL_LEN</code> (see <a href="https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h">limit_ioccc.h</a>).</li>
@@ -1556,10 +1592,10 @@ or <code>https://</code> or is longer than <code>MAX_URL_LEN</code> chars (see
 or does not have anything after the <code>http://</code> or <code>https://</code>.</li>
 <li>A <em>mastodon handle</em>, if provided, is not in the form of
 <code>@user@site</code> (i.e. starts with an <code>@</code>, has text following it and then another
-<code>@</code> followed by more text and has no other <code>@</code>) or is longer than <code>MAX_MASTODON_LEN</code> (see
+<code>@</code> followed by more text and has no other <code>@</code>), or if it is longer than <code>MAX_MASTODON_LEN</code> (see
 <a href="https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h">limit_ioccc.h</a>).</li>
 <li>A <em>GitHub account</em>, if provided, does not start with an <code>@</code>,
-has more than one <code>@</code> or is longer than <code>MAX_GITHUB_LEN</code> (see
+has more than one <code>@</code>, does not have any text after the <code>@</code> or is longer than <code>MAX_GITHUB_LEN</code> (see
 <a href="https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h">limit_ioccc.h</a>).</li>
 <li>An <em>affiliation</em>, if provided, is longer than
 <code>MAX_AFFILIATION_LEN</code> (see <a href="https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h">limit_ioccc.h</a>).</li>
@@ -1567,6 +1603,9 @@ has more than one <code>@</code> or is longer than <code>MAX_GITHUB_LEN</code> (
 not match the regexp <code>^[0-9A-Za-z][0-9A-Za-z._+-]*$</code>.</li>
 <li>An <em>author handle</em> is repeated.</li>
 </ul>
+<p>The program does confirm that the information for each author is correct,
+allowing you to correct the information without having to start the program
+over.</p>
 <p>Although the <code>mkiocccentry(1)</code> tool will verify everything for you, you may wish
 to validate different parts individually with the different tools. As the
 <a href="next/rules.html">rules</a> state, each of these tools has a <code>-h</code> option.</p>
@@ -1585,9 +1624,12 @@ FAQ on “<a href="#fnamchk">fnamchk</a>”
 for more details on the tools that <code>mkiocccentry</code> either executes directly or
 indirectly as part of the packaging process, especially if you wish to run one
 or more of these tools manually.</p>
+<p>See also the
+FAQ on “<a href="#mkiocccentry_test">how to test everything at once without having to answer
+questions</a>”.</p>
 <p>See also the <a href="next/guidelines.html">Guidelines</a> and the <a href="next/rules.html">Rules</a>
-(especially <a href="next/rules.html#rule2">Rule 2</a>, <a href="next/rules.html#rule17">Rule
-17</a>, <a href="next/rules.html#rule20">Rule 20</a>).</p>
+(especially <a href="next/rules.html#rule1">Rule 1</a>, <a href="next/rules.html#rule2">Rule 2</a>, <a href="next/rules.html#rule17">Rule
+17</a>, <a href="next/rules.html#rule19">Rule 19</a> and <a href="next/rules.html#rule20">Rule 20</a>).</p>
 <p>Jump to: <a href="#">top</a></p>
 <div id="txzchk">
 <div id="tarball">
diff --git a/faq.md b/faq.md
index 35ad3d7c6..b23bb52fc 100644
--- a/faq.md
+++ b/faq.md
@@ -1,6 +1,6 @@
 # IOCCC FAQ Table of Contents
 
-This is FAQ version **28.2.7 2025-02-09**.
+This is FAQ version **28.2.8 2025-02-10**.
 
 
 ## 0. [Entering the IOCCC: the bare minimum you need to know](#enter_questions)
@@ -1212,45 +1212,61 @@ Jump to: [top](#)
 ### Q 3.0: What is the `mkiocccentry(1)` process and what sort of checks does it perform?
 </div>
 
-The `mkiocccentry(1)` tool performs the following steps:
+In full, the `mkiocccentry(1)` tool performs the following steps:
 
-0. Ask the user for a submission ID (see the [quick-start
-guide](quick-start.html) for more details on how to obtain this).
-    * If this is an invalid UUID (malformed), it is an error.
-1. Ask the user for the submission slot (the submission number; see [Rule
-17](next/rules.html#rule17) for more details).
-    * If this is out of range it is an error (see `MAX_SUBMIT_SLOT` in
-    [limit_ioccc.h](https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h)).
+0. Ask the user for a submission ID (see the [how to register](next/register.html)
+for more details on how to obtain this and [Rule 17](next/rules.html#rule17) for
+the importance of this).
+    * If this is an invalid UUID (malformed), you will be asked to correct it
+    until it is.
+1. Ask the user for the submission slot (the submission number; see [how to
+register](next/register.html) and [Rule 17](next/rules.html#rule17) for more details).
+    * If this is out of range (see `MAX_SUBMIT_SLOT` in
+    [limit_ioccc.h](https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h))
+    and you will be asked to correct it until it is.
+2. Make the submission directory under `topdir` in the form of
+`workdir/submit.USERNAME-SLOT.TIMESTAMP` (the timestamp is calculated by
+`mkiocccentry(1)` so you do not have to worry about this).
+    * If this directory already exists it is an error.
 3. Change to the `topdir`.
-4. Traverses the directory, creating lists of ignored
+4. Traverse the directory, creating lists of ignored/forbidden
 files/directories/symlinks as well as a list directories to make and a list of
-files to copy to the submission directory.
+files to copy to the submission directory (and if (sub)directories are found
+with files, copy those files to their respective directory). Note the following:
     * If the depth is too deep it is an error (see `MAX_PATH_DEPTH` in
     [limit_ioccc.h](https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h)).
-    * If there are too many directories it is an error (see `MAX_DIR_COUNT` in
+    * If there are too many extra directories (total count not including the
+    submission directory itself, unrelated to `MAX_PATH_DEPTH` above) it is an
+    error (see `MAX_EXTRA_DIR_COUNT` in
+    [limit_ioccc.h](https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h)).
+    * If the max path length is <= 0 it is an error (and a bug).
+    * If the max depth is <= 0 it is an error (and a bug).
+    * If the max filename length is <= 0 it is an error (and a bug).
+    * If a path is NULL it is an error.
+    * If a path is an empty string it is an error.
+    * If the path length (i.e. `strlen(path)` where path starts after the
+    initial `./` of the path in the `topdir`) is too long it is an error (see `MAX_PATH_LEN` in
+    [limit_ioccc.h](https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h)).
+    * If a filename (last component of the path) is too long it is an error (see `MAX_FILENAME_LEN` in
     [limit_ioccc.h](https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h)).
     * If a filename or directory name is not a sane relative path, not allowed
     or will not be added for some other reason, it will be added to a relevant list to show to
-    the user later, to let them know it is ignored. By `relative` we mean it
-    must not start with `/` and by `sane` we mean that each component must match
-    the regexp: `^[0-9A-Za-z]+[0-9A-Za-z_+.-]*$`.
-    * If the path length (i.e. the entire length of the path from the `topdir`)
-    is too long it is an error (see `MAX_PATH_LEN` in
-    [limit_ioccc.h](https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h)).
-    * If a filename is too long it is an error (see `MAX_FILENAME_LEN` in
-    [limit_ioccc.h](https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h)).
-    * If there is an unknown error it is an error :-)
-    * If a path is NULL it is an error.
-    * If a path is an empty string it is an error.
-    * If the max path length is <= 0 it is an error (and a bug).
-    * If the max depth is <= 0 it is an error (and a bug).
-    * If the max filename length is <= 0 it is an error (and a  bug).
-    * If a directory is not readable it is an error.
+    the user later, to let them know it will not be added to the submission. By `relative` we mean it
+    must not start with `/` (which shouldn't happen even if you give an absolute
+    path) and by `sane` we mean that each component must match the regexp: `^[0-9A-Za-z]+[0-9A-Za-z_+.-]*$`.
+    * If a directory is unreadable it is an error.
+    * If a directory causes a cycle in the tree it is an error.
+    * If `stat(2)` on the path fails it is an error.
     * If `prog.c`, `Makefile` or `remarks.md` is/are not found it is an error.
     * If too many files that are not `prog.c`, `Makefile`, `remarks.md`,
     `try.sh`, `prog.alt.c` or `try.alt.sh` are found, it is an error (see
     `MAX_EXTRA_FILE_COUNT` in
     [limit_ioccc.h](https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h)).
+    * Symlinks are not allowed but it is not an error (they will be added to a
+    list and ignored).
+    * If any file type other than a regular file, a directory or a symlink is
+    encountered it is an error.
+    * If there is an unknown error it is an error :-)
 5. Show each list to the user, asking if this is okay. The lists include:
     * Ignored directories (those like `.git`, `CVS`, `RCCS` and `.svn`).
     * Unsafe directory names that will not be added (i.e. those that are not
@@ -1264,25 +1280,29 @@ files to copy to the submission directory.
     * Directories to be made.
     * Required files (`prog.c`, `Makefile` and `remarks.md`) to be copied.
     * Non-required files to be copied.
-    * The user is asked to verify each list, including the list of files to be
-    added, and if the user says it is not OK the program will abort.
+    * The user is asked to verify each list, including the lists of directories
+    and files to be made/copied, and if the user says it is not OK the program will abort.
 6. Make any directories if necessary (under
 `workdir/submit.USERNAME-SLOT.TIMESTAMP` i.e. the submission directory).
     * Directories **MUST** be and are made with mode `0755`.
     * If any directory is not this mode `txzchk(1)` will flag it.
 7. The non-ignored files are copied to their respective directories under the
 submission directory.
-    * `try.sh` and `try.alt.sh` MUST be and are copied as mode `0555`.
+    * `try.sh` and `try.alt.sh` **MUST** be and are copied as mode `0555`.
     * All other files **MUST** be and are copied as mode `0444`.
-    * Anything else is an error and `txzchk(1)` will flag this.
+    * Anything else will be flagged by `txzchk(1)`.
 8. `cd submit.USERNAME-SLOT.TIMESTAMP` (i.e. switch to submission directory).
 9. `make -f Makefile clobber`.
-    * If this fails it is not an error but you are warned about it (even so, see [Rule 20](next/rules.html#rule20)).
+    * If this fails it is not an error but you are warned about it (it is an error only if the `Makefile`
+    does not exist); even so, see [Rule 20](next/rules.html#rule20).
 10. Traverse the new tree from `.` with additional steps from (4).
     * If any file has an ignored directory name in it, it is an error.
     * If a symlink is found it is an error.
+    * If any file type other than a directory or regular file exists it is an
+    error.
     * If a forbidden filename exists it is an error.
-    * If any file or directory starts with `/` or is not POSIX plus + safe chars only it is an error.
+    * If any file or directory starts with `/` or is not POSIX plus + safe chars
+    only (see (4) above) it is an error.
     * If the depth is too deep it is an error.
     * If `prog.c`, `Makefile` or `remarks.md` are missing (or not readable
     regular files) it is an error.
@@ -1298,10 +1318,12 @@ submission directory.
     * `check_remarks_md()` will be run on your `remarks.m`; if it is not a
     regular readable file or it is empty it is an error. Otherwise it will
     proceed. Note it does not check that there is any text in the file, just
-    that the file size is not 0.
-    * If any other error condition in step (4) occurs it is also an error.
-11. Report on files that were copied in (3) and directories made in (3) but are
-now gone: asking the user to verify.
+    that the file size is not 0, and having a `remarks.md` that is not size 0
+    but has no content is violating [Rule 17](next/rules.html#rule17) and [Rule
+    19](next/rules.html#rule19).
+    * If any other error condition from step (4) occurs it is also an error.
+11. Report on any directories that were made and files that were copied in (7)
+but are now gone: asking the user to verify.
 12. Present the list of non-dot files that remain and ask the user to confirm.
 13. Ask the user for a submission title.
 14. Ask the user for a one line abstract of the submission.
@@ -1309,38 +1331,46 @@ now gone: asking the user to verify.
 questions (see below for more information on what kind of questions).
 16. Show the output of `ls -lakR .`, asking the user to confirm that the listing
 is okay.
-17. Create the tarball.
-18. Run `txzchk(1)` on the tarball.
+17. Create `.info.json` and run `chkentry(1)` on it.
+    * If `chkentry(1)` fails to validate the file make sure that you have
+    obtained and compiled the latest version of all the tools and you either are
+    in the repo's directory, you pass the options to give the path to the tools
+    or you have installed the latest tools!
+18. Create `.auth.json` and run `chkentry(1)` on it.
+    * If `chkentry(1)` fails to validate the file make sure that you have
+    obtained and compiled the latest version of all the tools and you either are
+    in the repo's directory, you pass the options to give the path to the tools
+    or you have installed the latest tools!
+19. Create the tarball.
+20. Run `txzchk(1)` on the tarball.
 
 If any of the steps fail or if the user says something is not okay, it aborts.
+Some of the other checks that are made:
 
-Some of the checks that are made:
-
-- If the files do not exist, are not regular files or cannot be read.
 - If `prog.c` violates [Rule 2](next/rules.html#rule2) (see
 [iocccsize.c](https://github.com/ioccc-src/mkiocccentry/blob/master/iocccsize.c)).
-- If `prog.c` is empty.
-- If `prog.c` has any high bit char (see
-[iocccsize.c](https://github.com/ioccc-src/mkiocccentry/blob/master/iocccsize.c)).
-- If `prog.c` has any NUL char (see
-[iocccsize.c](https://github.com/ioccc-src/mkiocccentry/blob/master/iocccsize.c)).
+- If `prog.c` is empty (see [Rule 1](next/rules.html#rule1) and the
+[Guidelines](next/guidelines.html)).
+- If `prog.c` has any NUL (`\0`) char (see
+[rule_count.c](https://github.com/ioccc-src/mkiocccentry/blob/master/soup/rule_count.c)).
 - If `prog.c` has any unknown or invalid trigraph (see
-[iocccsize.c](https://github.com/ioccc-src/mkiocccentry/blob/master/iocccsize.c)).
+[rule_count.c](https://github.com/ioccc-src/mkiocccentry/blob/master/soup/rule_count.c)).
 - If `prog.c` triggers a word buffer overflow (see
-[iocccsize.c](https://github.com/ioccc-src/mkiocccentry/blob/master/iocccsize.c)).
+[rule_count.c](https://github.com/ioccc-src/mkiocccentry/blob/master/soup/rule_count.c)).
 - If `prog.c` triggers an `ungetc(3)` error (see
-[iocccsize.c](https://github.com/ioccc-src/mkiocccentry/blob/master/iocccsize.c)).
+[rule_count.c](https://github.com/ioccc-src/mkiocccentry/blob/master/soup/rule_count.c)).
 - If the first rule in the `Makefile` is not `all`.
 - If the `Makefile` does not have a `clean` rule.
 - If the `Makefile` does not have a `clobber` rule.
 - If the `Makefile` does not have a `try` rule.
 
-If your `Makefile` is empty or `remarks.md` is empty it is an error and you will
-have to fix it.
 
-Conditions that one must correct, and which `mkiocccentry(1)` will prompt until
+Conditions that one **MUST** correct, and which `mkiocccentry(1)` will prompt until
 they are correct, are:
 
+- Your _contest ID_ is invalidly formed.
+- Your _submit slot_ is < 0 or > `MAX_SUBMIT_SLOT` (see
+[limit_ioccc.h](https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h)).
 - Your _title_ is not in the range of 1 through `MAX_TITLE_LEN` chars (see
 [limit_ioccc.h](https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h)).
 - Your _title_ does not match the regexp `^[0-9a-z][0-9a-z._+-]*$`.
@@ -1351,8 +1381,7 @@ they are correct, are:
 - An author _name_ is not 1 through `MAX_NAME_LEN` chars (see
 [limit_ioccc.h](https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h)).
 - Duplicate author _name_.
-- _Country code_ is invalid (not ISO 3166-1 2 character
-codes).
+- _Country code_ is invalid (i.e. it is not a ISO 3166-1 2 character code).
 - An _email_, if provided, is not in the format of `x@y` or
 if `x` or `y` contain a `@`, are empty or if the total length is longer than
 `MAX_EMAIL_LEN` (see [limit_ioccc.h](https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h)).
@@ -1362,10 +1391,10 @@ or `https://` or is longer than `MAX_URL_LEN` chars (see
 or does not have anything after the `http://` or `https://`.
 - A _mastodon handle_, if provided, is not in the form of
 `@user@site` (i.e. starts with an `@`, has text following it and then another
-`@` followed by more text and has no other `@`)  or is longer than `MAX_MASTODON_LEN` (see
+`@` followed by more text and has no other `@`), or if it is longer than `MAX_MASTODON_LEN` (see
 [limit_ioccc.h](https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h)).
 - A _GitHub account_, if provided, does not start with an `@`,
-has more than one `@` or is longer than `MAX_GITHUB_LEN` (see
+has more than one `@`, does not have any text after the `@` or is longer than `MAX_GITHUB_LEN` (see
 [limit_ioccc.h](https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h)).
 - An _affiliation_, if provided, is longer than
 `MAX_AFFILIATION_LEN` (see [limit_ioccc.h](https://github.com/ioccc-src/mkiocccentry/blob/master/soup/limit_ioccc.h)).
@@ -1373,6 +1402,10 @@ has more than one `@` or is longer than `MAX_GITHUB_LEN` (see
 not match the regexp `^[0-9A-Za-z][0-9A-Za-z._+-]*$`.
 - An _author handle_ is repeated.
 
+The program does confirm that the information for each author is correct,
+allowing you to correct the information without having to start the program
+over.
+
 Although the `mkiocccentry(1)` tool will verify everything for you, you may wish
 to validate different parts individually with the different tools. As the
 [rules](next/rules.html) state, each of these tools has a `-h` option.
@@ -1393,9 +1426,13 @@ for more details on the tools that `mkiocccentry` either executes directly or
 indirectly as part of the packaging process, especially if you wish to run one
 or more of these tools manually.
 
+See also the
+FAQ on "[how to test everything at once without having to answer
+questions](#mkiocccentry_test)".
+
 See also the [Guidelines](next/guidelines.html) and the [Rules](next/rules.html)
-(especially [Rule 2](next/rules.html#rule2), [Rule
-17](next/rules.html#rule17), [Rule 20](next/rules.html#rule20)).
+(especially [Rule 1](next/rules.html#rule1), [Rule 2](next/rules.html#rule2), [Rule
+17](next/rules.html#rule17), [Rule 19](next/rules.html#rule19) and [Rule 20](next/rules.html#rule20)).
 
 Jump to: [top](#)
 
diff --git a/next/rules.html b/next/rules.html
index 9e525a639..eac4b8e46 100644
--- a/next/rules.html
+++ b/next/rules.html
@@ -461,7 +461,7 @@ writing by <a href="../contact.html">contacting the judges</a>.</p>
 </div>
 </div>
 <p class="leftbar">
-These <a href="rules.html">IOCCC rules</a> are version <strong>28.22 2025-02-08</strong>.
+These <a href="rules.html">IOCCC rules</a> are version <strong>28.23 2025-02-10</strong>.
 </p>
 <p class="leftbar">
 The <a href="rules.md" download="rules.md">markdown form of these rules</a>
@@ -1295,7 +1295,7 @@ guidelines</a> for additional markdown guidance.
 make(1) compatibility the IOCCC
 supports</a> for more details.</p>
 <p class="leftbar">
-You are <strong>ENCOURAGED</strong> to use
+You are <strong>ENCOURAGED</strong> to use the
 Makefile example, renamed as <code>Makefile</code> of course, for help in constructing your
 <code>Makefile</code>. See the <a href="guidelines.html#makefile">Makefile section</a> in the
 guidelines for more details.
diff --git a/next/rules.md b/next/rules.md
index 13d7dacb6..8dfc688f8 100644
--- a/next/rules.md
+++ b/next/rules.md
@@ -53,7 +53,7 @@ Jump to: [top](#)
 
 
 <p class="leftbar">
-These [IOCCC rules](rules.html) are version **28.22 2025-02-08**.
+These [IOCCC rules](rules.html) are version **28.23 2025-02-10**.
 </p>
 
 <p class="leftbar">
@@ -1105,7 +1105,7 @@ make&lpar;1&rpar; compatibility the IOCCC
 supports](../faq.html#make_compatibility) for more details.
 
 <p class="leftbar">
-You are **ENCOURAGED** to use
+You are **ENCOURAGED** to use the
 Makefile example, renamed as `Makefile` of course, for help in constructing your
 `Makefile`. See the [Makefile section](guidelines.html#makefile) in the
 guidelines for more details.