From 8c4db22a5e7ffb23fe80a34e744dbc813ad757b1 Mon Sep 17 00:00:00 2001 From: Landon Curt Noll Date: Fri, 6 Dec 2024 22:26:32 -0800 Subject: [PATCH] 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. --- inc/guidelines.closed.hdr | 20 +++++++------------- inc/rules.closed.hdr | 24 +++++++++++------------ next/guidelines.html | 31 +++++++++++++++--------------- next/guidelines.md | 40 ++++++++++++++++++++------------------- next/rules.html | 20 ++++++++------------ next/rules.md | 26 +++++++++---------------- 6 files changed, 71 insertions(+), 90 deletions(-) diff --git a/inc/guidelines.closed.hdr b/inc/guidelines.closed.hdr index 6c6f15acf..ac1b93bff 100644 --- a/inc/guidelines.closed.hdr +++ b/inc/guidelines.closed.hdr @@ -1,24 +1,18 @@ -# 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 **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. +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 [@IOCCC mastodon feed](https://fosstodon.org/@ioccc) for information about future IOCCC openings. diff --git a/inc/rules.closed.hdr b/inc/rules.closed.hdr index a8760ef66..c465daa60 100644 --- a/inc/rules.closed.hdr +++ b/inc/rules.closed.hdr @@ -1,24 +1,22 @@ -# 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 **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. +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 [@IOCCC mastodon feed](https://fosstodon.org/@ioccc) for information about future IOCCC openings. diff --git a/next/guidelines.html b/next/guidelines.html index b6283fffc..346d0e3c8 100644 --- a/next/guidelines.html +++ b/next/guidelines.html @@ -425,25 +425,15 @@ -

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” -as well as our -FAQ on “asking questions” -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”” -and the -FAQ section “Entering the IOCCC: more help and details”.

The IOCCC is closed

The IOCCC is NOT accepting new submissions at this time. See the IOCCC winning entries page for the entries that have won the 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 as well +as our FAQ about asking questions about +these guidelines.

Watch both the IOCCC status page and the @IOCCC mastodon feed for information about future IOCCC openings.

@@ -467,7 +457,7 @@ writing by contacting the judges.

-These IOCCC guidelines are version 28.26 2024-12-06. +These IOCCC guidelines are version 28.27 2024-12-06.

IMPORTANT: Be SURE to read the IOCCC rules.

Jump to: top

@@ -1199,6 +1189,15 @@ use the COTHER Makefile variable. For example:

Again, please note that in macOS, /usr/bin/gcc is actually clang!

+
+

The clobber rule

+
+

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

Jump to: top

diff --git a/next/guidelines.md b/next/guidelines.md index 41cd8435e..7e99cbb8e 100644 --- a/next/guidelines.md +++ b/next/guidelines.md @@ -1,29 +1,18 @@ -# 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 **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. +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 [@IOCCC mastodon feed](https://fosstodon.org/@ioccc) for information about future IOCCC openings. @@ -54,7 +43,7 @@ Jump to: [top](#)

-These [IOCCC guidelines](guidelines.html) are version **28.26 2024-12-06**. +These [IOCCC guidelines](guidelines.html) are version **28.27 2024-12-06**.

**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`!

+ +
+## The clobber rule +
+ +

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

+ + Jump to: [top](#)
diff --git a/next/rules.html b/next/rules.html index ab21860aa..4a549edc3 100644 --- a/next/rules.html +++ b/next/rules.html @@ -425,12 +425,12 @@ -

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.

+

The IOCCC is closed

+

The IOCCC is NOT accepting new submissions at this time. See the +IOCCC winning entries page for the entries that have won the +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” as well as our @@ -438,10 +438,6 @@ FAQ on “about asking questions” 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”.

-

The IOCCC is closed

-

The IOCCC is NOT accepting new submissions at this time. See the -IOCCC winning entries page for the entries that have won the -IOCCC in the past.

Watch both the IOCCC status page and the @IOCCC mastodon feed for information about future IOCCC openings.

@@ -1117,9 +1113,9 @@ C source file must be called prog.c.

${CPP}.

Do NOT assume that . (the current directory) is in the $PATH.

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

diff --git a/next/rules.md b/next/rules.md index 479742fa7..0a8fac484 100644 --- a/next/rules.md +++ b/next/rules.md @@ -1,12 +1,13 @@ -# WARNING: These rules are OUT OF DATE +# The IOCCC is closed -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. +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. + +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)" @@ -16,15 +17,6 @@ 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). - - - -# 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 [@IOCCC mastodon feed](https://fosstodon.org/@ioccc) for information about 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`.

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