From 902d6a3f25391790a40ed40414f38069b53fd2a9 Mon Sep 17 00:00:00 2001 From: Cody Boone Ferguson <53008573+xexyl@users.noreply.github.com> Date: Tue, 2 Jul 2024 05:54:01 -0700 Subject: [PATCH] Format fixes in guidelines With the exception of some code blocks they now look much nicer on a smaller screen. --- next/guidelines.html | 42 +++++++++++++++++++++++------------------- next/guidelines.md | 43 +++++++++++++++++++++++-------------------- 2 files changed, 46 insertions(+), 39 deletions(-) diff --git a/next/guidelines.html b/next/guidelines.html index 0f18a8dc2..9cd0103de 100644 --- a/next/guidelines.html +++ b/next/guidelines.html @@ -459,7 +459,7 @@ you are using the correct versions of these items before using the IOCCC submission URL.

| The Rule 2a size has increased from 4096 to 4993 bytes.

| The Rule 2b size has increased from 2053 to 2503 bytes.

-

| The default way to compile submissions is now -std=gnu17 -O3 -g3 -Wall -Wextra -pedantic. See below for more details about the example Makefile +

| The new default way to compile submissions: -std=gnu17 -O3 -g3 -Wall -Wextra -pedantic. See below for more details about the example Makefile for more help.

| Submissions are in the form of a single xz compressed tarball.

| To assist in the formation of the xz compressed tarball for submission, use the @@ -565,11 +565,13 @@ ASCII formfeed, and ASCII carriage return.

In cases where the above summary and the algorithm implemented by the IOCCC size tool source code conflict, the algorithm implemented by the IOCCC size tool source code is preferred by the judges.

-

| There are at least 2 other reasons for selecting 2503 as the 2nd limit
-| besides the fact that 2503 is a prime. These reasons
-| may be searched for and discovered if you are “Curios!” about 2503. :-)
-| Moreover, 2053 was the number of the kernel disk pack of one of the
-| judge’s BESM-6, and 2503 is a decimal anagram of 2053.

+

| There are at least 2 other reasons for selecting
+| 2503 as the 2nd limit besides the fact that 2503
+| is a prime. These reasons may be searched for
+| and discovered if you are “Curios!” about 2503. :-)
+| Moreover, 2053 was the number of the kernel disk
+| pack of one of the judge’s BESM-6, and 2503 is a
+| decimal anagram of 2053.

Take note that this secondary limit imposed by the IOCCC size tool obviates some of the need to #define C reserved words in an effort to get around the size limits of Rule 2.

@@ -589,7 +591,8 @@ you may wish to validate each part individually. As the rul state, each of these tools have a -h option. However, to help simplify matters, we give you a brief overview below.

| The synopsis of the mkiocccentry(1) tool is:

-
    ./mkiocccentry [options] work_dir prog.c Makefile remarks.md [file ...]
+
    ./mkiocccentry [options] work_dir prog.c \
+         Makefile remarks.md [file ...]

| where the work_dir is a directory that is used to form the xz compressed tarball that txzchk(1) validates, prog.c is your submission source code, Makefile is your Makefile, remarks.md is your remarks and @@ -671,7 +674,7 @@ If you pass a single argument, it is expected to be a directory that has both # run checks on .auth.json: ./chkentry . .auth.json - # run checks on both .info.json and .auth.json: + # run checks on .info.json and .auth.json: ./chkentry .info.json .auth.json

| If there is a JSON issue detected by jparse(8), then there is a JSON @@ -870,7 +873,7 @@ interfaces to their compilers, once one learns how to invoke a shell.

Specification environment. Therefore do not assume the system has a windows.h include file:

-
    #include <windows.h>        /* we DISLIKE this include */
+
    #include <windows.h>  /* we DISLIKE this */

Unless you are cramped for space, or unless you are entering the ‘Best one liner’ category, we suggest that you format your program in a more creative way than simply forming excessively long lines.

@@ -901,7 +904,9 @@ absolute one. The intent is to ensure that the building if your program is reasonably portable.

We prefer programs that are portable across a wide variety of Unix-like operating systems (e.g., Linux, GNU Hurd, BSD, Unix, etc.).

+

You are in a maze of twisty guidelines, all different.

+

There are at least zero judges who think that Fideism has little or nothing to do with the IOCCC judging process.

@@ -991,12 +996,12 @@ particular window manager.

| You are well advised to submit entries that conform to the Single UNIX Specification Version 4.

| To quote the IOCCC judges:

-

You very well might not be completely be prohibited from failing to not
-partly misunderstand this particular guideline, but of course, we could
-not possibly comment! :-) Nevertheless, you are neither prohibited, nor are
-you fully required to determine that this or the previous sentence is either false
-and/or perhaps misleading. Therefore, it might be wise for you to not fail to
-consider to not do so, accordingly. Thank you very much.

+

You very well might not be completely be prohibited from failing to not partly +misunderstand this particular guideline, but of course, we could not possibly +comment! :-) Nevertheless, you are neither prohibited, nor are you fully +required to determine that this or the previous sentence is either false and/or +perhaps misleading. Therefore, it might be wise for you to not fail to consider +to not do so, accordingly. Thank you very much.

Any complaints about the above guideline could be addressed to the Speaker of the House of Commons, or to the speaker of your national @@ -1247,10 +1252,9 @@ This is one of the reasons why the IOCCC rules and

Entries are judged by Leonid A. Broukhis and Landon Curt Noll.

Each submission submitted is given a random id number and subdirectory. The -submission files including, but not limited to prog.c, Makefile (that we -form from your submitted Makefile and any additional “how to build” -information you provide), as well as any data files that you submit are all -placed under their own directory and stored and judged from this directory.

+submission files including, but not limited to prog.c, Makefile, +remarks.md as well as any data files that you submit, are all placed under +their own directory and stored and judged from this directory.

Any information about the authors is not read by the judges until the judging process is complete, and then only from entries that have won an award. Because we do not read this information for entries that diff --git a/next/guidelines.md b/next/guidelines.md index da2210de7..2fb3c0631 100644 --- a/next/guidelines.md +++ b/next/guidelines.md @@ -109,7 +109,7 @@ IOCCC submission URL. **`|`** The [Rule 2b](rules.html#rule2b) size has **increased from 2053 to 2503** bytes. -**`|`** The default way to compile submissions is now `-std=gnu17 -O3 -g3 +**`|`** The new default way to compile submissions: `-std=gnu17 -O3 -g3 -Wall -Wextra -pedantic`. See below for more details about the example Makefile for more help. @@ -249,11 +249,13 @@ In cases where the above summary and the algorithm implemented by the IOCCC size tool source code conflict, the algorithm implemented by the IOCCC size tool source code is preferred by the judges. -**`|`** There are at least 2 other reasons for selecting 2503 as the 2nd limit
-**`|`** besides the fact that 2503 is a prime. These reasons
-**`|`** may be searched for and discovered if you are ["Curios!" about 2503](https://t5k.org/curios/page.php/2503.html). :-)
-**`|`** Moreover, 2053 was the number of the kernel disk pack of one of the
-**`|`** judge's BESM-6, and 2503 is a decimal anagram of 2053. +**`|`** There are at least 2 other reasons for selecting
+**`|`** 2503 as the 2nd limit besides the fact that 2503
+**`|`** is a prime. These reasons may be searched for
+**`|`** and discovered if you are ["Curios!" about 2503](https://t5k.org/curios/page.php/2503.html). :-)
+**`|`** Moreover, 2053 was the number of the kernel disk
+**`|`** pack of one of the judge's BESM-6, and 2503 is a
+**`|`** decimal anagram of 2053. Take note that this secondary limit imposed by the IOCCC size tool obviates some of the need to `#define` C reserved words in an effort @@ -283,7 +285,8 @@ matters, we give you a brief overview below. **`|`** The synopsis of the `mkiocccentry(1)` tool is: ``` - ./mkiocccentry [options] work_dir prog.c Makefile remarks.md [file ...] + ./mkiocccentry [options] work_dir prog.c \ + Makefile remarks.md [file ...] ``` **`|`** where the `work_dir` is a directory that is used to form the @@ -397,7 +400,7 @@ If you pass a single argument, it is expected to be a directory that has both # run checks on .auth.json: ./chkentry . .auth.json - # run checks on both .info.json and .auth.json: + # run checks on .info.json and .auth.json: ./chkentry .info.json .auth.json ``` @@ -687,8 +690,9 @@ Specification](https://en.wikipedia.org/wiki/Single_UNIX_Specification) environment. Therefore do not assume the system has a [windows.h](https://en.wikipedia.org/wiki/Windows.h) include file: + ``` - #include /* we DISLIKE this include */ + #include /* we DISLIKE this */ ``` Unless you are cramped for space, or unless you are entering the @@ -730,7 +734,7 @@ program is reasonably portable. We prefer programs that are portable across a wide variety of Unix-like operating systems (e.g., Linux, GNU Hurd, BSD, Unix, etc.). -You are in a maze of twisty _guidelines_, all different. +> You are in a maze of twisty _guidelines_, all different. There are at least zero judges who think that [Fideism](https://en.wikipedia.org/wiki/Fideism) has little @@ -862,12 +866,12 @@ particular window manager. **`|`** To quote the [IOCCC judges](../judges.html): -> You very well might not be completely be prohibited from failing to not
-> partly misunderstand this particular _guideline_, but of course, we could
-> not possibly comment! :-) Nevertheless, you are neither prohibited, nor are
-> you fully required to determine that this or the previous sentence is either false
-> and/or perhaps misleading. Therefore, it might be wise for you to not fail to
-> consider to not do so, accordingly. Thank you very much. +> You very well might not be completely be prohibited from failing to not partly +misunderstand this particular _guideline_, but of course, we could not possibly +comment! :-) Nevertheless, you are neither prohibited, nor are you fully +required to determine that this or the previous sentence is either false and/or +perhaps misleading. Therefore, it might be wise for you to not fail to consider +to not do so, accordingly. Thank you very much. Any complaints about the above _guideline_ could be addressed to the Speaker of the House of Commons, or to the speaker of your national @@ -1169,10 +1173,9 @@ This is one of the reasons why the [IOCCC rules](rules.html) and Entries are judged by Leonid A. Broukhis and Landon Curt Noll. Each submission submitted is given a random id number and subdirectory. The -submission files including, but not limited to `prog.c`, `Makefile` (that we -form from your submitted `Makefile` and any additional "**how to build**" -information you provide), as well as any data files that you submit are all -placed under their own directory and stored and judged from this directory. +submission files including, but not limited to `prog.c`, `Makefile`, +`remarks.md` as well as any data files that you submit, are all placed under +their own directory and stored and judged from this directory. Any information about the authors is not read by the judges until the judging process is complete, and then only from entries that have