improve rules and guidelines

We improved the rules language around `make clobber` to not insist,
but instead request actions to restore the state of the submission.

Updated `inc/rules.closed.hdr` and `inc/guidelines.closed.hdr` to clarify
the tentative nature of the rules and guidelines without implying
that they might be massively changed before the IOCCC re-opened.
The `next/rules.md` and `next/guidelines.md` have been updated to
include the `inc/rules.closed.hdr` and `inc/guidelines.closed.hdr`
content respectively.

The top level warning that the rules and guidelines are out of date
have been removed.

Performed `make rules guidelines` to update the HTML pages.
This commit is contained in:
Landon Curt Noll committed 2024-12-06 22:26:32 -08:00
1 parent c6fe86e0e6
commit 8c4db22a5e
6 files changed
+71 -90

No files matched your search

+7 -13
View File
@@ -1,24 +1,18 @@
<!-- START: this line starts content from: inc/guidelines.closed.hdr --> <!-- START: this line starts content from: inc/guidelines.closed.hdr -->
# WARNING: These guidelines are OUT OF DATE
These guidelines are a **VERY TENTATIVE proposal** for the next IOCCC
and are **VERY LIKELY** to be updated before the next IOCCC.
They are are provided as a **VERY TENTATIVE** hint at **what
MIGHT** be used in the next IOCCC. In some cases they might
even be a copy of the guidelines from the previous IOCCC.
See our [FAQ about providing feedback](../faq.html#feedback) as well
as our [FAQ about asking questions](../faq.html#question) about
these guidelines.
# The IOCCC is closed # The IOCCC is closed
The IOCCC is **NOT** accepting new submissions at this time. See the The IOCCC is **NOT** accepting new submissions at this time. See the
[IOCCC winning entries page](../years.html) for the entries that have won the [IOCCC winning entries page](../years.html) for the entries that have won the
IOCCC in the past. IOCCC in the past.
These guidelines are a **TENTATIVE proposal** for the next IOCCC
and are **likely be to be updated** before the next IOCCC.
See our [FAQ about providing feedback](../faq.html#feedback) as well
as our [FAQ about asking questions](../faq.html#question) about
these guidelines.
Watch both [the IOCCC status page](../status.html) and the Watch both [the IOCCC status page](../status.html) and the
[@IOCCC mastodon feed](https://fosstodon.org/@ioccc) for information about [@IOCCC mastodon feed](https://fosstodon.org/@ioccc) for information about
future IOCCC openings. future IOCCC openings.
+11 -13
View File
@@ -1,24 +1,22 @@
<!-- START: this line starts content from: inc/rules.closed.hdr --> <!-- START: this line starts content from: inc/rules.closed.hdr -->
# WARNING: These rules are OUT OF DATE
These rules are a **VERY TENTATIVE proposal** for the next IOCCC
and are **VERY LIKELY** to be updated before the next IOCCC.
They are are provided as a **VERY TENTATIVE** hint at **what
MIGHT** be used in the next IOCCC. In some cases they might
even be a copy of the rules from the previous IOCCC.
See our [FAQ about providing feedback](../faq.html#feedback) as well
as our [FAQ about asking questions](../faq.html#question) about
these rules.
# The IOCCC is closed # The IOCCC is closed
The IOCCC is **NOT** accepting new submissions at this time. See the The IOCCC is **NOT** accepting new submissions at this time. See the
[IOCCC winning entries page](../years.html) for the entries that have won the [IOCCC winning entries page](../years.html) for the entries that have won the
IOCCC in the past. IOCCC in the past.
These rules are a **TENTATIVE proposal** for the next IOCCC
and are **likely be to be updated** before the next IOCCC.
See our
FAQ on "[rules, guidelines, tools feedback](../faq.html#feedback)"
as well as our
FAQ on "[about asking questions](../faq.html#question)"
about these rules. You might also find the
FAQ in general useful, especially the
[FAQ section "How to enter: the bare minimum you need to know"](../faq.html#submit).
Watch both [the IOCCC status page](../status.html) and the Watch both [the IOCCC status page](../status.html) and the
[@IOCCC mastodon feed](https://fosstodon.org/@ioccc) for information about [@IOCCC mastodon feed](https://fosstodon.org/@ioccc) for information about
future IOCCC openings. future IOCCC openings.
+15 -16
View File
@@ -425,25 +425,15 @@
<!-- BEFORE: 1st line of markdown file: next/guidelines.md --> <!-- BEFORE: 1st line of markdown file: next/guidelines.md -->
<!-- START: this line starts content from: inc/guidelines.closed.hdr --> <!-- START: this line starts content from: inc/guidelines.closed.hdr -->
<h1 id="warning-these-guidelines-are-out-of-date">WARNING: These guidelines are OUT OF DATE</h1>
<p>These guidelines are a <strong>VERY TENTATIVE proposal</strong> for the next IOCCC
and are <strong>VERY LIKELY</strong> to be updated before the next IOCCC.
They are are provided as a <strong>VERY TENTATIVE</strong> hint at <strong>what
MIGHT</strong> be used in the next IOCCC. In some cases they might
even be a copy of the guidelines from the previous IOCCC.</p>
<p>See our
FAQ on “<a href="../faq.html#feedback">rules, guidelines, tools feedback</a>”
as well as our
FAQ on “<a href="../faq.html#question">asking questions</a>”
about these guidelines. You might also find the
FAQ in general useful, especially the
FAQ section “<a href="../faq.html#submit">How to enter: the bare minimum you need to know”</a>”
and the
FAQ section “<a href="../faq.html#submitting_help">Entering the IOCCC: more help and details</a>”.</p>
<h1 id="the-ioccc-is-closed">The IOCCC is closed</h1> <h1 id="the-ioccc-is-closed">The IOCCC is closed</h1>
<p>The IOCCC is <strong>NOT</strong> accepting new submissions at this time. See the <p>The IOCCC is <strong>NOT</strong> accepting new submissions at this time. See the
<a href="../years.html">IOCCC winning entries page</a> for the entries that have won the <a href="../years.html">IOCCC winning entries page</a> for the entries that have won the
IOCCC in the past.</p> IOCCC in the past.</p>
<p>These guidelines are a <strong>TENTATIVE proposal</strong> for the next IOCCC
and are <strong>likely be to be updated</strong> before the next IOCCC.</p>
<p>See our <a href="../faq.html#feedback">FAQ about providing feedback</a> as well
as our <a href="../faq.html#question">FAQ about asking questions</a> about
these guidelines.</p>
<p>Watch both <a href="../status.html">the IOCCC status page</a> and the <p>Watch both <a href="../status.html">the IOCCC status page</a> and the
<a href="https://fosstodon.org/@ioccc"><span class="citation" data-cites="IOCCC">@IOCCC</span> mastodon feed</a> for information about <a href="https://fosstodon.org/@ioccc"><span class="citation" data-cites="IOCCC">@IOCCC</span> mastodon feed</a> for information about
future IOCCC openings.</p> future IOCCC openings.</p>
@@ -467,7 +457,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.26 2024-12-06</strong>. These <a href="guidelines.html">IOCCC guidelines</a> are version <strong>28.27 2024-12-06</strong>.
</p> </p>
<p><strong>IMPORTANT</strong>: Be <strong>SURE</strong> to read the <a href="rules.html">IOCCC rules</a>.</p> <p><strong>IMPORTANT</strong>: Be <strong>SURE</strong> to read the <a href="rules.html">IOCCC rules</a>.</p>
<p>Jump to: <a href="#">top</a></p> <p>Jump to: <a href="#">top</a></p>
@@ -1199,6 +1189,15 @@ use the <code>COTHER</code> Makefile variable. For example:
<p class="leftbar"> <p class="leftbar">
Again, please note that in macOS, <code>/usr/bin/gcc</code> is actually <code>clang</code>! Again, please note that in macOS, <code>/usr/bin/gcc</code> is actually <code>clang</code>!
</p> </p>
<div id="clobber">
<h2 id="the-clobber-rule">The clobber rule</h2>
</div>
<p class="leftbar">
When <code>make clobber</code> is invoked, we request that submission be restored
to its original submission state. For example, any temporary files
created during the build process, or during execution should be
removed by the <code>clobber</code> rule.
</p>
<p>Jump to: <a href="#">top</a></p> <p>Jump to: <a href="#">top</a></p>
<div id="likes"> <div id="likes">
<div id="dislikes"> <div id="dislikes">
+21 -19
View File
@@ -1,29 +1,18 @@
<!-- START: this line starts content from: inc/guidelines.closed.hdr --> <!-- START: this line starts content from: inc/guidelines.closed.hdr -->
# WARNING: These guidelines are OUT OF DATE
These guidelines are a **VERY TENTATIVE proposal** for the next IOCCC
and are **VERY LIKELY** to be updated before the next IOCCC.
They are are provided as a **VERY TENTATIVE** hint at **what
MIGHT** be used in the next IOCCC. In some cases they might
even be a copy of the guidelines from the previous IOCCC.
See our
FAQ on "[rules, guidelines, tools feedback](../faq.html#feedback)"
as well as our
FAQ on "[asking questions](../faq.html#question)"
about these guidelines. You might also find the
FAQ in general useful, especially the
FAQ section "[How to enter: the bare minimum you need to know"](../faq.html#submit)"
and the
FAQ section "[Entering the IOCCC: more help and details](../faq.html#submitting_help)".
# The IOCCC is closed # The IOCCC is closed
The IOCCC is **NOT** accepting new submissions at this time. See the The IOCCC is **NOT** accepting new submissions at this time. See the
[IOCCC winning entries page](../years.html) for the entries that have won the [IOCCC winning entries page](../years.html) for the entries that have won the
IOCCC in the past. IOCCC in the past.
These guidelines are a **TENTATIVE proposal** for the next IOCCC
and are **likely be to be updated** before the next IOCCC.
See our [FAQ about providing feedback](../faq.html#feedback) as well
as our [FAQ about asking questions](../faq.html#question) about
these guidelines.
Watch both [the IOCCC status page](../status.html) and the Watch both [the IOCCC status page](../status.html) and the
[@IOCCC mastodon feed](https://fosstodon.org/@ioccc) for information about [@IOCCC mastodon feed](https://fosstodon.org/@ioccc) for information about
future IOCCC openings. future IOCCC openings.
@@ -54,7 +43,7 @@ Jump to: [top](#)
</div> </div>
<p class="leftbar"> <p class="leftbar">
These [IOCCC guidelines](guidelines.html) are version **28.26 2024-12-06**. These [IOCCC guidelines](guidelines.html) are version **28.27 2024-12-06**.
</p> </p>
**IMPORTANT**: Be **SURE** to read the [IOCCC rules](rules.html). **IMPORTANT**: Be **SURE** to read the [IOCCC rules](rules.html).
@@ -983,6 +972,19 @@ _and_ `clang`** support it.
Again, please note that in macOS, `/usr/bin/gcc` is actually `clang`! Again, please note that in macOS, `/usr/bin/gcc` is actually `clang`!
</p> </p>
<div id="clobber">
## The clobber rule
</div>
<p class="leftbar">
When `make clobber` is invoked, we request that submission be restored
to its original submission state. For example, any temporary files
created during the build process, or during execution should be
removed by the `clobber` rule.
</p>
Jump to: [top](#) Jump to: [top](#)
<div id="likes"> <div id="likes">
+8 -12
View File
@@ -425,12 +425,12 @@
<!-- BEFORE: 1st line of markdown file: next/rules.md --> <!-- BEFORE: 1st line of markdown file: next/rules.md -->
<!-- START: this line starts content from: inc/rules.closed.hdr --> <!-- START: this line starts content from: inc/rules.closed.hdr -->
<h1 id="warning-these-rules-are-out-of-date">WARNING: These rules are OUT OF DATE</h1> <h1 id="the-ioccc-is-closed">The IOCCC is closed</h1>
<p>These rules are a <strong>VERY TENTATIVE proposal</strong> for the next IOCCC <p>The IOCCC is <strong>NOT</strong> accepting new submissions at this time. See the
and are <strong>VERY LIKELY</strong> to be updated before the next IOCCC. <a href="../years.html">IOCCC winning entries page</a> for the entries that have won the
They are are provided as a <strong>VERY TENTATIVE</strong> hint at <strong>what IOCCC in the past.</p>
MIGHT</strong> be used in the next IOCCC. In some cases they might <p>These rules are a <strong>TENTATIVE proposal</strong> for the next IOCCC
even be a copy of the rules from the previous IOCCC.</p> and are <strong>likely be to be updated</strong> before the next IOCCC.</p>
<p>See our <p>See our
FAQ on “<a href="../faq.html#feedback">rules, guidelines, tools feedback</a>” FAQ on “<a href="../faq.html#feedback">rules, guidelines, tools feedback</a>”
as well as our as well as our
@@ -438,10 +438,6 @@ FAQ on “<a href="../faq.html#question">about asking questions</a>”
about these rules. You might also find the about these rules. You might also find the
FAQ in general useful, especially the FAQ in general useful, especially the
<a href="../faq.html#submit">FAQ section “How to enter: the bare minimum you need to know”</a>.</p> <a href="../faq.html#submit">FAQ section “How to enter: the bare minimum you need to know”</a>.</p>
<h1 id="the-ioccc-is-closed">The IOCCC is closed</h1>
<p>The IOCCC is <strong>NOT</strong> accepting new submissions at this time. See the
<a href="../years.html">IOCCC winning entries page</a> for the entries that have won the
IOCCC in the past.</p>
<p>Watch both <a href="../status.html">the IOCCC status page</a> and the <p>Watch both <a href="../status.html">the IOCCC status page</a> and the
<a href="https://fosstodon.org/@ioccc"><span class="citation" data-cites="IOCCC">@IOCCC</span> mastodon feed</a> for information about <a href="https://fosstodon.org/@ioccc"><span class="citation" data-cites="IOCCC">@IOCCC</span> mastodon feed</a> for information about
future IOCCC openings.</p> future IOCCC openings.</p>
@@ -1117,9 +1113,9 @@ C source file must be called <code>prog.c</code>.</p>
<code>${CPP}</code>.</p> <code>${CPP}</code>.</p>
<p>Do <strong>NOT</strong> assume that <code>.</code> (the current directory) is in the <code>$PATH</code>.</p> <p>Do <strong>NOT</strong> assume that <code>.</code> (the current directory) is in the <code>$PATH</code>.</p>
<p class="leftbar"> <p class="leftbar">
When <code>make clobber</code> is invoked, your submission <strong>MUST</strong> be restored When <code>make clobber</code> is invoked, we request that submission be restored
to its original submission state. For example, any temporary files to its original submission state. For example, any temporary files
created during the build process, or during execution <strong>MUST</strong> be created during the build process, or during execution should be
removed by the <code>clobber</code> rule. removed by the <code>clobber</code> rule.
</p> </p>
<p class="leftbar"> <p class="leftbar">
+9 -17
View File
@@ -1,12 +1,13 @@
<!-- START: this line starts content from: inc/rules.closed.hdr --> <!-- START: this line starts content from: inc/rules.closed.hdr -->
# WARNING: These rules are OUT OF DATE # The IOCCC is closed
These rules are a **VERY TENTATIVE proposal** for the next IOCCC The IOCCC is **NOT** accepting new submissions at this time. See the
and are **VERY LIKELY** to be updated before the next IOCCC. [IOCCC winning entries page](../years.html) for the entries that have won the
They are are provided as a **VERY TENTATIVE** hint at **what IOCCC in the past.
MIGHT** be used in the next IOCCC. In some cases they might
even be a copy of the rules from the previous IOCCC. These rules are a **TENTATIVE proposal** for the next IOCCC
and are **likely be to be updated** before the next IOCCC.
See our See our
FAQ on "[rules, guidelines, tools feedback](../faq.html#feedback)" FAQ on "[rules, guidelines, tools feedback](../faq.html#feedback)"
@@ -16,15 +17,6 @@ about these rules. You might also find the
FAQ in general useful, especially the FAQ in general useful, especially the
[FAQ section "How to enter: the bare minimum you need to know"](../faq.html#submit). [FAQ section "How to enter: the bare minimum you need to know"](../faq.html#submit).
# The IOCCC is closed
The IOCCC is **NOT** accepting new submissions at this time. See the
[IOCCC winning entries page](../years.html) for the entries that have won the
IOCCC in the past.
Watch both [the IOCCC status page](../status.html) and the Watch both [the IOCCC status page](../status.html) and the
[@IOCCC mastodon feed](https://fosstodon.org/@ioccc) for information about [@IOCCC mastodon feed](https://fosstodon.org/@ioccc) for information about
future IOCCC openings. future IOCCC openings.
@@ -844,9 +836,9 @@ To invoke the C compiler, use `${CC}`. To invoke the C preprocessor use
Do **NOT** assume that `.` (the current directory) is in the `$PATH`. Do **NOT** assume that `.` (the current directory) is in the `$PATH`.
<p class="leftbar"> <p class="leftbar">
When `make clobber` is invoked, your submission **MUST** be restored When `make clobber` is invoked, we request that submission be restored
to its original submission state. For example, any temporary files to its original submission state. For example, any temporary files
created during the build process, or during execution **MUST** be created during the build process, or during execution should be
removed by the `clobber` rule. removed by the `clobber` rule.
</p> </p>