21701 is the seed) to have the tool make up pseudo-randomly selected
answers.
Please note that the tool will NOT delete the directory it makes so if you
-do have to try again you’ll have to remove it.
+do have to try again you’ll have to remove it (you can have it delete it if you
+use the -x option though).
An example use of this option is:
mkiocccentry -d workdir topdir
This will run the tests that mkiocccentry(1), write the JSON files, use
chkentry(1), package the tarball and run txzchk(1) on it.
+If you don’t want to deal with the having to move or delete the submission
+directory, you could instead do:
+ mkiocccentry -x -d workdir topdir
See also the
FAQ on “mkiocccentry”,
the
@@ -1496,23 +1501,41 @@ do this AFTER the contest status has
open.
Jump to: top
+
Q 1.9: How can I avoid re-entering my UUID to mkiocccentry?
+
Because some people might want to submit more than one submission, an option to
read the UUID from a file exists, so that you don’t have to repeatedly copy and
paste the UUID in. If the file is not a regular readable file or it does not
have a valid UUID, you will be prompted as if you had not used the option. If
you use the -i answers feature this will not be used as the UUID is included
in the answers file.
-To use this feature all you have to do is put the UUID in a text file, in a
-single line, with no spaces before or after it, and then run:
+There are two ways to do this - it is purely a matter of preference. The first
+way is to put your UUID in a text file (the UUID by itself on a single line)
+with no spaces before or after it, and then run:
mkiocccentry -u uuid workdir topdir
where uuid is the file containing your UUID, workdir is the workdir and
topdir is the topdir.
+The second way is to specify the UUID on the command line itself. For instance
+if your UUID was test (for test mode) you could do:
+ mkiocccentry -U test workdir topdir
See also the
FAQ on “the answers file”.
Jump to: top
+
+
Q 1.10: How can I avoid having to move or delete my submission directory for the same workdir?
+
+If you wish to not have to worry about removing or moving the submission
+directory under the workdir, you may use the -x option to mkiocccentry. For
+instance, you can do:
+ mkiocccentry -x workdir topdir
+and if the submission directory under workdir already exists it will be removed
+first so you do not have to do so.
+If for some reason your rm command cannot be found or does not exist you can
+specify the path by the -r rm option.
+Jump to: top
@@ -1899,8 +1922,12 @@ the importance of this).
- If this is an invalid UUID (malformed), you will be asked to correct it
until it is.
-- If the
-u uuid option is used and the UUID in the file uuid is not malformed,
+ - If the
-u uuidfile option is used and the UUID in the file uuidfile is not malformed,
the user will not be prompted for a UUID.
+- If the
-U uuidstr option is used and the UUID is not malformed, the user
+will not be prompted for a UUID.
+- The
-u and -U options may not be used with any option that reads from
+an answers file (-i answers, -d, -s seed).
Ask the user for the submission slot (the submission number; see how to
register and Rule 17 for more details).
@@ -1912,7 +1939,10 @@ you will be asked to correct it until it is.
Make the submission directory under topdir in the form of
workdir/submit.USERNAME-SLOT.
-- If this directory already exists it is an error.
+- If this directory already exists it is an error, unless the
-x option is
+used, in which case it’ll be deleted.
+- If for some reason the default
rm paths do not work, you may use -r rm
+to specify the path to a working rm command.
Change to the topdir.
Traverse the directory, creating lists of ignored/forbidden
diff --git a/faq.md b/faq.md
index 8c7784ea9..449efcf06 100644
--- a/faq.md
+++ b/faq.md
@@ -1,6 +1,6 @@
# IOCCC FAQ Table of Contents
-This is FAQ version **28.2.14 2025-03-09**.
+This is FAQ version **28.2.15 2025-03-10**.
## 0. [Entering the IOCCC: the bare minimum you need to know](#enter_questions)
@@ -28,7 +28,8 @@ This is FAQ version **28.2.14 2025-03-09**.
- **Q 1.6**: What are extra files and how may I include additional files beyond the max allowed?
- **Q 1.7**: May I use AI, Virtual coding assistants, or similar tools to write my submission?
- **Q 1.8**: What are the details behind Rule 17?
-- **Q 1.9**: How can I avoid re-entering my UUID to mkiocccentry?
+- **Q 1.9**: How can I avoid re-entering my UUID to mkiocccentry?
+- **Q 1.10**: How can I avoid having to move or delete my submission directory for the same workdir?
## 2. [IOCCC Judging process](#judging_proceess)
@@ -785,7 +786,8 @@ where `21701` is the seed) to have the tool make up pseudo-randomly selected
answers.
Please note that the tool will **NOT** delete the directory it makes so if you
-do have to try again you'll have to remove it.
+do have to try again you'll have to remove it (you can have it delete it if you
+use the `-x` option though).
An example use of this option is:
@@ -796,6 +798,13 @@ An example use of this option is:
This will run the tests that `mkiocccentry(1)`, write the JSON files, use
`chkentry(1)`, package the tarball and run `txzchk(1)` on it.
+If you don't want to deal with the having to move or delete the submission
+directory, you could instead do:
+
+```
+ mkiocccentry -x -d workdir topdir
+```
+
See also the
FAQ on "[mkiocccentry](#mkiocccentry)",
the
@@ -1267,9 +1276,12 @@ do this **AFTER** the [contest status](status.html) has changed to
Jump to: [top](#)
+
+
### Q 1.9: How can I avoid re-entering my UUID to mkiocccentry?
+
Because some people might want to submit more than one submission, an option to
read the UUID from a file exists, so that you don't have to repeatedly copy and
@@ -1278,8 +1290,9 @@ have a valid UUID, you will be prompted as if you had not used the option. If
you use the `-i answers` feature this will not be used as the UUID is included
in the answers file.
-To use this feature all you have to do is put the UUID in a text file, in a
-single line, with no spaces before or after it, and then run:
+There are two ways to do this - it is purely a matter of preference. The first
+way is to put your UUID in a text file (the UUID by itself on a single line)
+with no spaces before or after it, and then run:
```
mkiocccentry -u uuid workdir topdir
@@ -1288,11 +1301,38 @@ single line, with no spaces before or after it, and then run:
where `uuid` is the file containing your UUID, `workdir` is the workdir and
`topdir` is the topdir.
+The second way is to specify the UUID on the command line itself. For instance
+if your UUID was `test` (for test mode) you could do:
+
+```
+ mkiocccentry -U test workdir topdir
+```
+
+
See also the
FAQ on "[the answers file](#answers_file)".
Jump to: [top](#)
+
+### Q 1.10: How can I avoid having to move or delete my submission directory for the same workdir?
+
+
+If you wish to not have to worry about removing or moving the submission
+directory under the workdir, you may use the `-x` option to `mkiocccentry`. For
+instance, you can do:
+
+```
+ mkiocccentry -x workdir topdir
+```
+
+and if the submission directory under workdir already exists it will be removed
+first so you do not have to do so.
+
+If for some reason your `rm` command cannot be found or does not exist you can
+specify the path by the `-r rm` option.
+
+Jump to: [top](#)
@@ -1788,8 +1828,12 @@ 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.
- * If the `-u uuid` option is used and the UUID in the file `uuid` is not malformed,
+ * If the `-u uuidfile` option is used and the UUID in the file `uuidfile` is not malformed,
the user will not be prompted for a UUID.
+ * If the `-U uuidstr` option is used and the UUID is not malformed, the user
+ will not be prompted for a UUID.
+ * The `-u` and `-U` options may not be used with any option that reads from
+ an answers file (`-i answers`, `-d`, `-s seed`).
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
@@ -1797,7 +1841,10 @@ register](next/register.html) and [Rule 17](next/rules.html#rule17) for more det
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`.
- * If this directory already exists it is an error.
+ * If this directory already exists it is an error, unless the `-x` option is
+ used, in which case it'll be deleted.
+ * If for some reason the default `rm` paths do not work, you may use `-r rm`
+ to specify the path to a working `rm` command.
3. Change to the `topdir`.
4. Traverse the directory, creating lists of ignored/forbidden
files/directories/symlinks as well as a list directories to make and a list of
diff --git a/next/guidelines.html b/next/guidelines.html
index 982094d4f..595418b03 100644
--- a/next/guidelines.html
+++ b/next/guidelines.html
@@ -464,7 +464,7 @@ writing by contacting the judges.
-These IOCCC guidelines are version 28.44 2025-03-04.
+These IOCCC guidelines are version 28.45 2025-03-10.
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.
+
+
Until the contest status becomes open,
the IOCCC rules,
IOCCC guidelines and the tools in the
@@ -595,7 +600,7 @@ previously uploaded submission by rebuilding your submission with the
submit server.
-HINT: So that you do not have to repeatedly answer all the
+HINT: so that you do not have to repeatedly answer all the
questions, the mkiocccentry(1) tool has the options -a answers, -A answers
and -i answers, where -a will write to an answers file (if it does not
already exist), -A WILL OVERWRITE THE FILE and -i will read the answers from
@@ -609,6 +614,14 @@ circumvent this you can use the -Y option but we do not recommend t
if your update breaks a rule or there is some problem, you might not see it.
+To help with not having to repeatedly enter a UUID, whether for the same
+submission or multiple submissions, you can use the -u uuidfile or -U UUID
+option. See the
+FAQ on “how to avoid re-entering your UUID”
+for more details. Note that the -i answers option cannot be used with the UUID
+options as the answers file includes the UUID.
+
+
The overall size limit (see Rule 2a) on prog.c has been
increased from 4096 to 4993 bytes.
The Rule 2a size was changed from
diff --git a/next/guidelines.md b/next/guidelines.md
index 13d4a0551..0ab881950 100644
--- a/next/guidelines.md
+++ b/next/guidelines.md
@@ -53,7 +53,7 @@ Jump to: [top](#)
-These [IOCCC guidelines](guidelines.html) are version **28.44 2025-03-04**.
+These [IOCCC guidelines](guidelines.html) are version **28.45 2025-03-10**.
@@ -142,6 +142,13 @@ 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.
+
+
Until the contest status becomes **[open](../faq.html#open)**,
the [IOCCC rules](rules.html),
@@ -214,7 +221,7 @@ previously uploaded submission by rebuilding your submission with the
-**HINT:** So that you do not have to repeatedly answer all the
+**HINT:** so that you do not have to repeatedly answer all the
questions, the `mkiocccentry(1)` tool has the options `-a answers`, `-A answers`
and `-i answers`, where `-a` will write to an answers file (if it does not
already exist), `-A` **WILL OVERWRITE THE FILE** and `-i` will read the answers from
@@ -229,6 +236,15 @@ circumvent this you can use the `-Y` option but we do not recommend this because
if your update breaks a rule or there is some problem, you might not see it.
+
+To help with not having to repeatedly enter a UUID, whether for the same
+submission or multiple submissions, you can use the `-u uuidfile` or `-U UUID`
+option. See the
+FAQ on "[how to avoid re-entering your UUID](../faq.html#uuid)"
+for more details. Note that the `-i answers` option cannot be used with the UUID
+options as the answers file includes the UUID.
+
+
The overall size limit (see [Rule 2a](rules.html#rule2a)) on `prog.c` has been
**increased from 4096 to 4993** bytes.