From ea24f6b0d0702eaf5dd7667d598d40b51e2afdcf Mon Sep 17 00:00:00 2001 From: Cody Boone Ferguson <53008573+xexyl@users.noreply.github.com> Date: Sun, 28 Sep 2025 03:54:31 -0700 Subject: [PATCH] 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. --- next/guidelines.html | 25 +++++-------------------- next/guidelines.md | 28 +++++----------------------- 2 files changed, 10 insertions(+), 43 deletions(-) diff --git a/next/guidelines.html b/next/guidelines.html index 0f91e17a8..b5be100a6 100644 --- a/next/guidelines.html +++ b/next/guidelines.html @@ -488,7 +488,7 @@ writing by contacting the judges.

-These IOCCC guidelines are version 28.47 2025-03-15. +These IOCCC guidelines are version 28.48 2025-09-28.

The markdown form of these guidelines calcula to be a functional UTC time. :-)

-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. -

-

-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” -for more details and the -FAQ on “obtaining the most recent release of the -toolkit” -for more help. -

-

Until the contest status becomes open, the IOCCC rules, IOCCC guidelines and the tools in the @@ -860,12 +844,12 @@ FAQ on “obtaining the mkiocccentr

mkiocccentry runs a number of checks, by the tool itself and by executing other tools, before packaging your xz compressed tarball, including running -chkentry(1) on the submission directory. +chksubmit(1) on the submission directory.

If mkiocccentry encounters an error, the program will exit and the xz compressed tarball will not be formed. For instance, if -chkentry fails to validate the submission directory, either because +chksubmit fails to validate the submission directory, either because of a validation error in the .auth.json or .info.json JSON files or because of something else that mkiocccentry(1) 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 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 -chkentry(1), txzchk(1) and fnamchk(1). +chksubmit(1), txzchk(1) and fnamchk(1).

Make sure you have @@ -2003,6 +1987,7 @@ tools, including, but not limited to mkiocccentry, chkentry, +chksubmit, fnamchk and location, diff --git a/next/guidelines.md b/next/guidelines.md index fe4a6c94a..d8332e8f9 100644 --- a/next/guidelines.md +++ b/next/guidelines.md @@ -48,7 +48,7 @@ Jump to: [top](#)

-These [IOCCC guidelines](guidelines.html) are version **28.47 2025-03-15**. +These [IOCCC guidelines](guidelines.html) are version **28.48 2025-09-28**.

@@ -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. :-)

-

-**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. -

- -

-**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. -

-

Until the contest status becomes **[open](../faq.html#open)**, the [IOCCC rules](rules.html), @@ -508,13 +489,13 @@ FAQ on "[obtaining the mkiocccentry toolkit](../faq.html#obtaining_mkiocccentry)

`mkiocccentry` runs a number of checks, by the tool itself and by executing other tools, _before_ packaging your xz compressed tarball, including running -`chkentry(1)` on the submission directory. +`chksubmit(1)` on the submission directory.

If `mkiocccentry` encounters an **error**, the program will exit and the xz 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` [JSON](https://www.json.org/json-en.html) files or because of 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 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 -`chkentry(1)`, `txzchk(1)` and `fnamchk(1)`. +`chksubmit(1)`, `txzchk(1)` and `fnamchk(1)`.

@@ -1946,6 +1927,7 @@ tools](https://github.com/ioccc-src/mkiocccentry), _including, **but not limited**_ to [mkiocccentry](https://github.com/ioccc-src/mkiocccentry/blob/master/mkiocccentry.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) and [location](https://github.com/ioccc-src/mkiocccentry/blob/master/soup/location_main.c),