Minor fixes and updates go next/guidelines

Some information is no longer useful - they were put in during the
IOCCC28 to let people know the version changes during the contest which
noted some useful information.

Also added references to chksubmit.

Rebuilt next/guidelines.html with these changes.
This commit is contained in:
Cody Boone Ferguson committed 2025-09-28 03:54:31 -07:00
1 parent 16aa4af108
commit ea24f6b0d0
2 files changed
+10 -43

No files matched your search

+5 -20
View File
@@ -488,7 +488,7 @@ writing by <a href="../contact.html">contacting the judges</a>.</p>
</div> </div>
</div> </div>
<p class="leftbar"> <p class="leftbar">
These <a href="guidelines.html">IOCCC guidelines</a> are version <strong>28.47 2025-03-15</strong>. These <a href="guidelines.html">IOCCC guidelines</a> are version <strong>28.48 2025-09-28</strong>.
</p> </p>
<p class="leftbar"> <p class="leftbar">
The markdown form of these guidelines <a href="guidelines.md" The markdown form of these guidelines <a href="guidelines.md"
@@ -556,22 +556,6 @@ The reason for the times of day are so that key IOCCC events are <strong>calcula
to be a <strong>fun</strong>ctional UTC time. :-) to be a <strong>fun</strong>ctional UTC time. :-)
</p> </p>
<p class="leftbar"> <p class="leftbar">
<strong>NOTE</strong>: the updates to these guidelines on 2025-03-10 explained the new <code>-u uuidfile</code> and <code>-U uuidstr</code> options and are <strong>NOT</strong> important to read, in order
to follow the guidelines. The options are in a release <strong>AFTER THIS</strong> IOCCC’s
official release and not updating the toolkit is <strong>PERFECTLY</strong> okay.
</p>
<p class="leftbar">
<strong>NOTE</strong>: the updates to these guidelines on 2025-03-12 also explain how the
tools that require other tools now search under <code>$PATH</code>. It is perfectly fine to
not use the newer versions so long as you use the minimum required version of
the tools. See the
FAQ on “<a href="../faq.html#minimum_versions">minimum required version of the tools</a>”
for more details and the
FAQ on “<a href="../faq.html#obtaining_mkiocccentry">obtaining the most recent release of the
toolkit</a>”
for more help.
</p>
<p class="leftbar">
Until the contest status becomes <strong><a href="../faq.html#open">open</a></strong>, Until the contest status becomes <strong><a href="../faq.html#open">open</a></strong>,
the <a href="rules.html">IOCCC rules</a>, the <a href="rules.html">IOCCC rules</a>,
<a href="guidelines.html">IOCCC guidelines</a> and the tools in the <a href="guidelines.html">IOCCC guidelines</a> and the tools in the
@@ -860,12 +844,12 @@ FAQ on “<a href="../faq.html#obtaining_mkiocccentry">obtaining the mkiocccentr
<p class="leftbar"> <p class="leftbar">
<code>mkiocccentry</code> runs a number of checks, by the tool itself and by executing <code>mkiocccentry</code> runs a number of checks, by the tool itself and by executing
other tools, <em>before</em> packaging your xz compressed tarball, including running other tools, <em>before</em> packaging your xz compressed tarball, including running
<code>chkentry(1)</code> on the submission directory. <code>chksubmit(1)</code> on the submission directory.
</p> </p>
<p class="leftbar"> <p class="leftbar">
If <code>mkiocccentry</code> encounters an <strong>error</strong>, the program will exit and the xz If <code>mkiocccentry</code> encounters an <strong>error</strong>, the program will exit and the xz
compressed tarball <strong>will not be formed</strong>. For instance, if compressed tarball <strong>will not be formed</strong>. For instance, if
<a href="#chkentry">chkentry</a> fails to validate the submission directory, either because <a href="#chksubmit">chksubmit</a> fails to validate the submission directory, either because
of a validation error in the <code>.auth.json</code> or <code>.info.json</code> of a validation error in the <code>.auth.json</code> or <code>.info.json</code>
<a href="https://www.json.org/json-en.html">JSON</a> files or because of <a href="https://www.json.org/json-en.html">JSON</a> files or because of
something else that <code>mkiocccentry(1)</code> creates or does, it is an something else that <code>mkiocccentry(1)</code> creates or does, it is an
@@ -911,7 +895,7 @@ For example:
(specifying the absolute or relative path to the tool) and you have not (specifying the absolute or relative path to the tool) and you have not
installed the tools (and we <strong>STRONGLY</strong> recommend you <strong>do</strong> install them), installed the tools (and we <strong>STRONGLY</strong> recommend you <strong>do</strong> install them),
then you will have to specify the options (such as paths) for the tools that are required like then you will have to specify the options (such as paths) for the tools that are required like
<code>chkentry(1)</code>, <code>txzchk(1)</code> and <code>fnamchk(1)</code>. <code>chksubmit(1)</code>, <code>txzchk(1)</code> and <code>fnamchk(1)</code>.
</p> </p>
<p class="leftbar"> <p class="leftbar">
Make sure you have Make sure you have
@@ -2003,6 +1987,7 @@ tools</a>, <em>including, <strong>but not
limited</strong></em> to limited</strong></em> to
<a href="https://github.com/ioccc-src/mkiocccentry/blob/master/mkiocccentry.c">mkiocccentry</a>, <a href="https://github.com/ioccc-src/mkiocccentry/blob/master/mkiocccentry.c">mkiocccentry</a>,
<a href="https://github.com/ioccc-src/mkiocccentry/blob/master/chkentry.c">chkentry</a>, <a href="https://github.com/ioccc-src/mkiocccentry/blob/master/chkentry.c">chkentry</a>,
<a href="https://github.com/ioccc-src/mkiocccentry/blob/master/chksubmit.c">chksubmit</a>,
<a href="https://github.com/ioccc-src/mkiocccentry/blob/master/test_ioccc/fnamchk.c">fnamchk</a> <a href="https://github.com/ioccc-src/mkiocccentry/blob/master/test_ioccc/fnamchk.c">fnamchk</a>
and and
<a href="https://github.com/ioccc-src/mkiocccentry/blob/master/soup/location_main.c">location</a>, <a href="https://github.com/ioccc-src/mkiocccentry/blob/master/soup/location_main.c">location</a>,
+5 -23
View File
@@ -48,7 +48,7 @@ Jump to: [top](#)
</div> </div>
<p class="leftbar"> <p class="leftbar">
These [IOCCC guidelines](guidelines.html) are version **28.47 2025-03-15**. These [IOCCC guidelines](guidelines.html) are version **28.48 2025-09-28**.
</p> </p>
<p class="leftbar"> <p class="leftbar">
@@ -141,25 +141,6 @@ The reason for the times of day are so that key IOCCC events are **calculated**
to be a **fun**ctional UTC time. :-) to be a **fun**ctional UTC time. :-)
</p> </p>
<p class="leftbar">
**NOTE**: the updates to these guidelines on 2025-03-10 explained the new `-u
uuidfile` and `-U uuidstr` options and are **NOT** important to read, in order
to follow the guidelines. The options are in a release **AFTER THIS** IOCCC's
official release and not updating the toolkit is **PERFECTLY** okay.
</p>
<p class="leftbar">
**NOTE**: the updates to these guidelines on 2025-03-12 also explain how the
tools that require other tools now search under `$PATH`. It is perfectly fine to
not use the newer versions so long as you use the minimum required version of
the tools. See the
FAQ on "[minimum required version of the tools](../faq.html#minimum_versions)"
for more details and the
FAQ on "[obtaining the most recent release of the
toolkit](../faq.html#obtaining_mkiocccentry)"
for more help.
</p>
<p class="leftbar"> <p class="leftbar">
Until the contest status becomes **[open](../faq.html#open)**, Until the contest status becomes **[open](../faq.html#open)**,
the [IOCCC rules](rules.html), the [IOCCC rules](rules.html),
@@ -508,13 +489,13 @@ FAQ on "[obtaining the mkiocccentry toolkit](../faq.html#obtaining_mkiocccentry)
<p class="leftbar"> <p class="leftbar">
`mkiocccentry` runs a number of checks, by the tool itself and by executing `mkiocccentry` runs a number of checks, by the tool itself and by executing
other tools, _before_ packaging your xz compressed tarball, including running other tools, _before_ packaging your xz compressed tarball, including running
`chkentry(1)` on the submission directory. `chksubmit(1)` on the submission directory.
</p> </p>
<p class="leftbar"> <p class="leftbar">
If `mkiocccentry` encounters an **error**, the program will exit and the xz If `mkiocccentry` encounters an **error**, the program will exit and the xz
compressed tarball **will not be formed**. For instance, if compressed tarball **will not be formed**. For instance, if
[chkentry](#chkentry) fails to validate the submission directory, either because [chksubmit](#chksubmit) fails to validate the submission directory, either because
of a validation error in the `.auth.json` or `.info.json` of a validation error in the `.auth.json` or `.info.json`
[JSON](https://www.json.org/json-en.html) files or because of [JSON](https://www.json.org/json-en.html) files or because of
something else that `mkiocccentry(1)` creates or does, it is an something else that `mkiocccentry(1)` creates or does, it is an
@@ -569,7 +550,7 @@ For example:
(specifying the absolute or relative path to the tool) and you have not (specifying the absolute or relative path to the tool) and you have not
installed the tools (and we **STRONGLY** recommend you **do** install them), installed the tools (and we **STRONGLY** recommend you **do** install them),
then you will have to specify the options (such as paths) for the tools that are required like then you will have to specify the options (such as paths) for the tools that are required like
`chkentry(1)`, `txzchk(1)` and `fnamchk(1)`. `chksubmit(1)`, `txzchk(1)` and `fnamchk(1)`.
</p> </p>
<p class="leftbar"> <p class="leftbar">
@@ -1946,6 +1927,7 @@ tools](https://github.com/ioccc-src/mkiocccentry), _including, **but not
limited**_ to limited**_ to
[mkiocccentry](https://github.com/ioccc-src/mkiocccentry/blob/master/mkiocccentry.c), [mkiocccentry](https://github.com/ioccc-src/mkiocccentry/blob/master/mkiocccentry.c),
[chkentry](https://github.com/ioccc-src/mkiocccentry/blob/master/chkentry.c), [chkentry](https://github.com/ioccc-src/mkiocccentry/blob/master/chkentry.c),
[chksubmit](https://github.com/ioccc-src/mkiocccentry/blob/master/chksubmit.c),
[fnamchk](https://github.com/ioccc-src/mkiocccentry/blob/master/test_ioccc/fnamchk.c) [fnamchk](https://github.com/ioccc-src/mkiocccentry/blob/master/test_ioccc/fnamchk.c)
and and
[location](https://github.com/ioccc-src/mkiocccentry/blob/master/soup/location_main.c), [location](https://github.com/ioccc-src/mkiocccentry/blob/master/soup/location_main.c),