@@ -955,7 +956,7 @@ and
Rule 17 itself.
Do remember that if your submission requires different filenames, then you
MUST make a COPY of them in your Makefile. See also Rule
11.
-Jump to:
top
+
Jump to: top
@@ -1896,7 +1897,7 @@ entries that do not win on their web page for everyone to see.
Section 3: The mkiocccentry toolkit: finer details
-Jump to:
top
+
Jump to: top
Q 3.0: What is the mkiocccentry(1) process and what sort of checks does it perform?
@@ -6503,6 +6504,7 @@ announced in the early years of the IOCCC.
Q 11.6: I do not understand the IOCCC, can you explain it to me?
Please see the About the IOCCC page for more details.
+
Jump to: top
# if you use sudo(8):
sudo make install
@@ -332,7 +338,6 @@ above) run as either `sudo(8)` or root `make install`:
make install
```
-
If everything goes well you should be able to run `mkiocccentry(1)`,
`txzchk(1)`, `chkentry(1)` and all the other installed tools from any directory,
and the tools that rely on other tools will be able to find those required tools
@@ -341,8 +346,10 @@ from any directory too.
Some tools like `bug_report.sh` and `hostchk.sh` are not meant to be installed
and will not work from any directory, however.
+
Jump to: [top](#)
+
#### Q 0.1.5: How do I use mkiocccentry?
@@ -409,6 +416,7 @@ contest.
Jump to: [top](#)
+
#### Q 0.1.6: What are the minimum versions required for this contest?
@@ -424,8 +432,8 @@ At minimum, the tools **MUST** be version:
See also the
FAQ on "[obtaining the latest release of the toolkit](#obtaining_mkiocccentry)".
-Jump to: [top](#)
+Jump to: [top](#)
@@ -441,6 +449,7 @@ system that conforms to the [SUS](https://en.wikipedia.org/wiki/Single_UNIX_Spec
otherwise known as the [The Single UNIX Specification Version 4](https://unix.org/version4/)
or [later SUS](https://unix.org/online.html).
+
Jump to: [top](#)
@@ -482,6 +491,7 @@ compatible with this; see the
FAQ on "[Makefile compatibility](#gmake)"
for more details and help.
+
#### Expected `make` rules:
The following rules should exist in your Makefile:
@@ -512,8 +522,10 @@ date
does have other rules like `everything` and `alt`, and we encourage you to use
the one linked to above.
+
Jump to: [top](#)
+
+
Jump to: [top](#)
@@ -5441,6 +5516,7 @@ and there are some other benefits as well which you would miss if you did not
use them. Nevertheless, if you prefer to do it manually, whether to help you
process or appreciate the entry more, then please do so.
+
Jump to: [top](#)
@@ -5460,6 +5536,7 @@ usually away with `stty echo`. Sometimes you can also get away with `stty sane`.
clearing of the screen, however, that solves the problem, so `clear` will not
help.
+
Jump to: [top](#)
@@ -5506,8 +5583,10 @@ Please see the
FAQ on "[fixing an entry](#fix_an_entry)"
for how to submit a fix to an IOCCC entry.
+
Jump to: [top](#)
+
@@ -5547,8 +5626,10 @@ for details. See also the
FAQ on "[GitHub pull request](#pull_request)"
for more information about pull requests.
+
Jump to: [top](#)
+
@@ -5586,8 +5667,10 @@ to find what the `intr` is set to:
reason it's not you might have to do something else including just piping it to
just `grep intr` or whatever.
+
Jump to: [top](#)
+
### Q 7.4: How do I download individual winning entries or all winning entries of a given year?
@@ -5703,8 +5786,8 @@ browser to `1984/index.html`, scroll down to `Winning Entries of 1984 - The 1st
IOCCC` and click on the link `1984/mullender` which will take you to the
`index.html` file. Of course the caveats listed above still will apply.
-Jump to: [top](#)
+Jump to: [top](#)
@@ -5715,6 +5798,7 @@ Jump to: [top](#)
## Section 8: Changes made to IOCCC entries
+
Jump to: [top](#)
@@ -5763,7 +5847,6 @@ The following `make` rules exist to make a difference:
- This rule will show the diff of the entry to the original code (that is
`entry.c` to `entry.orig.c`).
-
For instance one of Landon's all time favourite entries is
[1984/mullender](1984/mullender/index.html) so the file names would be:
`mullender.orig.c`, `mullender.alt.c` and `mullender.c`. For later years, it
@@ -5851,6 +5934,7 @@ See the
FAQ on "[original source code files](#original_source_code)"
for more information.
+
Jump to: [top](#)
@@ -5875,7 +5959,6 @@ warning in such a way that caused confusing output for the entry, looking like:
# nothing here, what to do?
```
-
In some cases it is not possible to fix or at least it is highly unlikely and so
those have mainly not been touched except one that has had the buffer size
increased (which could be done for others that are not possible to change to
@@ -5903,6 +5986,7 @@ We're not sure how this is compatibility but either way it can cause a
problem and it is this that has complicated most of the fixes though again some
can look almost identical.
+
Jump to: [top](#)
@@ -5932,6 +6016,7 @@ and the
FAQ on "[entry source code changes](#what_changed)"
for more information.
+
Jump to: [top](#)
@@ -5944,6 +6029,7 @@ are the original winning entry or as close to as possible to the original that
we can find (in some cases a change was made by the Judges, for example, or an
author might have made a modification without saving the original).
+
Jump to: [top](#)
@@ -5982,6 +6068,7 @@ See also the
FAQ on "[original source code](#original_source_code)"
for more information.
+
Jump to: [top](#)
@@ -6006,6 +6093,7 @@ could no longer be so: `main()` instead had to call another function that has
the body of the old `main()` and that function would call itself again. In some
cases, however, this had to be done even without `clang` objections.
+
Jump to: [top](#)
@@ -6043,6 +6131,7 @@ In a few cases files were removed and there are multiple reasons for this too.
The end result is to help improve the presentation of the entries in some way or
ways.
+
Jump to: [top](#)
@@ -6096,6 +6185,7 @@ for more information on changes. If you want to see more details, including how
to see the actual differences, see the
FAQ on "[what changed in more detail](#detailed-diff)".
+
Jump to: [top](#)
@@ -6125,8 +6215,10 @@ other times something else.
There were certainly other reasons as well.
+
Jump to: [top](#)
+
@@ -6135,6 +6227,7 @@ Jump to: [top](#)
## Section 9: Helping the IOCCC
+
Jump to: [top](#)
@@ -6144,6 +6237,7 @@ Jump to: [top](#)
+
#### We welcome your help in fixing IOCCC entries
The [known bugs](bugs.html) file, order by IOCCC years, contains a
@@ -6160,6 +6254,7 @@ while a (mis)feature is not considered a bug and should **not be fixed**.
In cases where the bug is known, the entry's [known bugs](bugs.html) file
section may offer you important fixing clues.
+
#### We welcome your help on fixing the IOCCC website
This includes typos, dead/invalid links and many other things. Please see the
@@ -6185,6 +6280,7 @@ Note that just because an entry is not in the bugs file does not mean there is
not an issue and note that some issues are simply missing files, dead URL(s) or
something like that.
+
Jump to: [top](#)
@@ -6238,6 +6334,7 @@ for more information about pull requests.
Note that we're much more inclined to accept an author's fixes but the judges
have the final say in the matter.
+
Jump to: [top](#)
@@ -6269,6 +6366,7 @@ To help you out here is a navigation menu in this FAQ entry:
Go to [GitHub](https://github.com/) and click on 'Sign up'. Follow the
instructions. Once you've completed this task make sure you log in to GitHub.
+
#### Installing an ssh key to GitHub
Assuming you do not have an ssh key you should go to the command prompt and
@@ -6300,6 +6398,7 @@ it might be `~/.ssh/github.pub`.
Whatever the key file is, copy the contents and paste it into the GitHub field
labelled _Key_. Once you have done so click on _Add SSH key_.
+
#### Forking the IOCCC winner repo
Open in your browser the link:
@@ -6355,6 +6454,7 @@ where _foo_ is the file to add.
When he's ready to make a commit he would need to create a new branch for the
pull request.
+
#### Committing your changes
First, as an aside, if this is your first pull request (which we assume is if you're
@@ -6372,7 +6472,6 @@ Cody would see:
Now, assuming that the forked repo is
, you'd type:
-
```
git remote set-url origin git@github.com:xexyl/winner.git
```
@@ -6383,7 +6482,6 @@ Before doing anything else, however, a new branch needs to be created.
Continuing the example above for
[2020/ferguson1/play.sh](%%REPO_URL%%/2020/ferguson1/play.sh), it might be that:
-
```
git checkout -B human-snakes
```
@@ -6492,6 +6590,7 @@ example, you would type:
This will merge your pull request to your fork.
+
Jump to: [top](#)
@@ -6523,6 +6622,7 @@ already been reported. If it has been reported, feel free to add a comment to
the issue. Otherwise, if you do not see the same issue reported, then feel free
to [open a new IOCCC website issue](https://github.com/ioccc-src/winner/issues/new?assignees=&labels=website&projects=&template=website_issue.yml&title=%5BWebsite%5D+%3Ctitle%3E).
+
Jump to: [top](#)
@@ -6737,6 +6837,7 @@ See the
FAQ on "[fixing author information](#fix_author)"
for information about how to change author location codes.
+
Jump to: [top](#)
@@ -6792,6 +6893,7 @@ replace that text with:
If you just wish to report the bad link issue, see
FAQ on "[report website problem](#report_web_problem)".
+
Jump to: [top](#)
@@ -6816,6 +6918,7 @@ If you wish to express your support and/or appreciation for our
efforts, we suggest making an **Anonymous** gift via the
[IOCCC Amazon wishlist](https://www.amazon.com/hz/wishlist/ls/3HSNTEL8RQ1M0?ref_=wl_share).
+
Jump to: [top](#)
@@ -6913,6 +7016,7 @@ that be prove helpful.
**THANK YOU** in advance for your willingness to assist!
+
Jump to: [top](#)
@@ -6943,8 +7047,10 @@ IOCCC entry. See also the
FAQ on "[GitHub pull request](#pull_request)"
for more information about pull requests.
+
Jump to: [top](#)
+
@@ -6953,6 +7059,7 @@ Jump to: [top](#)
## Section 10: Miscellaneous IOCCC
+
Jump to: [top](#)
@@ -6989,6 +7096,7 @@ and certainly **OUT OF DATE**.
If you do make a new fork of **THIS** repo, we do ask that your fork keep up to
date with the latest changes when possible. Thank you.
+
Jump to: [top](#)
@@ -7014,6 +7122,7 @@ See
FAQ on "[using IOCCC content](#license)".
For additional information on the [Copyright and CC BY-SA 4.0 License](license.html).
+
Jump to: [top](#)
@@ -7061,6 +7170,7 @@ p.s. Here is an image of F. D. C. Willard:
alt="image of F.D.C.Willard.png"
width=600 height=401>
+
Jump to: [top](#)
@@ -7094,6 +7204,7 @@ The .top, .allyear, .year and .path files are generated from the top level Makef
make genpath
```
+
Jump to: [top](#)
@@ -7157,6 +7268,7 @@ such as old rules and old guidelines, terms such as _entry_ may still be
found. Moreover, out of habit, the IOCCC judges sometimes use old
names such as _entry_ when they should use _submission_. Sorry (tm Canada)! 🇨🇦:-)
+
Jump to: [top](#)
@@ -7194,6 +7306,7 @@ enjoy that those working on the IOCCC have proper Attribution
including, of course, the IOCCC winners themselves! It is designed
to help ensure that everyone may enjoy the IOCCC.
+
Jump to: [top](#)
@@ -7233,6 +7346,7 @@ follow posts something so you will have to check the IOCCC feed manually.
mastodon feed](https://fosstodon.org/@ioccc) page and/or mastodon
app from time to time to view IOCCC mastodon updates.
+
Jump to: [top](#)
@@ -7252,6 +7366,7 @@ can hit ESC to do this) and then type the command:
where `4` is the value you wish to set the tabstop to.
+
Jump to: [top](#)
@@ -7259,6 +7374,7 @@ Jump to: [top](#)
### Q 10.8: How do the menus on the website work and what can I do if they don't work?
+
@@ -7294,7 +7410,6 @@ For instance, on an iPhone 14
Pro Max or similar device (in dimensions), you should see at the top right of
every page, something that looks like:
-

@@ -7307,6 +7422,7 @@ In this case click on the icon at the top right corner that looks like:
to activate the menu.
+
@@ -7323,6 +7439,7 @@ menu](nojs-menu.html) which is a plaintext menu. You of course can use this if
you like, even if you do not have JavaScript enabled, by pointing your browser
to
.
+
@@ -7373,6 +7490,7 @@ least [report it as an
issue](https://github.com/ioccc-src/winner/issues/new/choose) (choose
the category _Website issue_).
+
Jump to: [top](#)
@@ -7398,6 +7516,7 @@ Of course if you know the author's name you can go directly to
[authors.html](authors.html) and click on their surname's/last name's/second
name's initial and then scroll down (if necessary) to the author in question.
+
Jump to: [top](#)
@@ -7410,6 +7529,7 @@ longer be available, code wise, except for Plan 9, but Plan 9 was never used for
judging the IOCCC. A Unix man page for `cb`
[still exists](https://www.ibm.com/docs/en/aix/7.3?topic=c-cb-command).
+
Jump to: [top](#)
@@ -7626,6 +7746,7 @@ Jump to: [top](#)
+
Jump to: [top](#)
@@ -7722,6 +7843,7 @@ P.S. Part of the inspiration for making the IOCCC a contest goes to the
reference to that (in)famous dark and stormy night all the way back in 1830 when
Landon was just a wee lad).
+
Jump to: [top](#)
@@ -7741,6 +7863,7 @@ and the website generation) and the JSON parser (for the tools, the contest and
the website) to make it easier and much more likely for the IOCCC to be held on
a yearly basis.
+
Jump to: [top](#)
@@ -7750,6 +7873,7 @@ Jump to: [top](#)
+
#### In the beginning of www.ioccc.org
The long history of the [official IOCCC website](https://www.ioccc.org) can be
@@ -7766,6 +7890,7 @@ repo](https://web.archive.org/web/20210101211346/https://www.ioccc.org/) on
site](https://www.ioccc.org) became a [GitHub Pages](https://pages.github.com)
website.
+
#### 2020 Dec 28 bzip2 compressed tarball archive
Furthermore, a bzip2 compressed tarball containing the released
@@ -7948,6 +8073,7 @@ and the [Pull Request 24 in the winner repo](https://github.com/ioccc-src/winner
The **Great Fork Merge** _changed 5,157 files_ with _843,045 additions_ and _137,758
deletions_, in _6,169 commits_ ‼️
+
Jump to: [top](#)
@@ -7964,6 +8090,7 @@ In later years, Rule 2 was split into two parts. These two parts of Rule 2 are:
* Rule 2a: Overall size limit of "prog.c"
* Rule 2b: Size of "prog.c", w/o counting certain types of characters
+
#### IOCCC 1984-1985
@@ -7973,6 +8100,7 @@ In later years, Rule 2 was split into two parts. These two parts of Rule 2 are:
* Rule 2a: 512
* Rule 2b: n/a
+
#### IOCCC 1986-1987
@@ -7982,6 +8110,7 @@ In later years, Rule 2 was split into two parts. These two parts of Rule 2 are:
* Rule 2a: 1024
* Rule 2b: n/a
+
#### IOCCC 1988-1991
@@ -7991,6 +8120,7 @@ In later years, Rule 2 was split into two parts. These two parts of Rule 2 are:
* Rule 2a: 1536
* Rule 2b: n/a
+
#### IOCCC 1992-2000
@@ -7998,6 +8128,7 @@ In later years, Rule 2 was split into two parts. These two parts of Rule 2 are:
* Rule 2a: 3217
* Rule 2b: 1536
+
#### IOCCC: 2001-2012
@@ -8005,6 +8136,7 @@ In later years, Rule 2 was split into two parts. These two parts of Rule 2 are:
* Rule 2a: 4096
* Rule 2b: 2048
+
#### IOCCC 2013-2020
@@ -8012,6 +8144,7 @@ In later years, Rule 2 was split into two parts. These two parts of Rule 2 are:
* Rule 2a: 4096
* Rule 2b: 2053
+
#### IOCCC 2024-date
@@ -8019,6 +8152,7 @@ In later years, Rule 2 was split into two parts. These two parts of Rule 2 are:
* Rule 2a: 4993
* Rule 2b: 2503
+
Jump to: [top](#)
@@ -8035,6 +8169,7 @@ See the
FAQ on "[Great Fork Merge Date](#great_fork_merge_date)"
for more information and stats.
+
Jump to: [top](#)
@@ -8050,6 +8185,7 @@ general [USENIX conference](https://www.usenix.org/conferences), usually
immediately after the BSD BOF, where the winners of a new IOCCC were
announced in the early years of the IOCCC.
+
Jump to: [top](#)
@@ -8060,6 +8196,9 @@ Jump to: [top](#)
Please see the [About the IOCCC page](about.html) for more details.
+Jump to: [top](#)
+
+