Thru the contest I have tried to instill two things in people. First is a disgust for poor coding style. Second was the notion of just how much utility is lost when a program is written in an unstructured -fashion. Contest winners help do this by what I call satirical +fashion. IOCCC winning entries help do this by what I call satirical programming. To see why, observe one of the definitions of satire:
@@ -187,8 +187,8 @@ exposing and discrediting vice or folly. into their programs. These programs in turn exposed and discredited what I considered to be the programmer’s equivalent of “vice or folly”. -There were two unexpected benefits that came from the contest -winners. First was an educational value to the programs. To understand +
There were two unexpected benefits that came from IOCCC winning +entries. First was an educational value to the programs. To understand these C programs is to understand subtle points of the C programming language. The second benefit is the entertainment value, which should become evident as you read further!
@@ -298,10 +298,10 @@ that you will gain an understanding that poor style destroys an otherwise correct program. Real programmers don’t write obfuscated programs, unless they are submitting a contest entry! :-)Happy pondering!
-About the IOCCC winner -GitHub repository
+About the IOCCC GitHub +repository
The official IOCCC -entries GitHub repository are the official winners of the +entries GitHub repository are the official entries that won the International Obfuscated C Code Contest (IOCCC), the Internet’s oldest ongoing contest.
IMPORTANT NOTE: See (with ONE PULL REQUEST PER FIX, please)!
We will be happy to credit anyone who submits successful GitHub pull requests in the thanks -file. If you’re a previous winner we will add a link to your winning -entries in the file (if you’re not a previous winner we can add a link -to your GitHub page or personal website if you have one, should you -wish).
+file. If you’re the author of an entry that win the IOCCC, we will add a +link to your winning entries in the file (if you’re not an author, we +can add a link to your GitHub page or personal website if you have one, +should you wish).If you do fix an entry please feel free to delete the entry from this file! Otherwise if you wish to not worry about it we can do that to make sure the format is consistent and clean.
diff --git a/bugs.md b/bugs.md index 8fec0c272..b16af4e58 100644 --- a/bugs.md +++ b/bugs.md @@ -21,10 +21,10 @@ REQUEST *PER* FIX, please)! We will be **happy to credit anyone who submits successful [GitHub pull requests](https://github.com/ioccc-src/temp-test-ioccc/pulls)** in the -[thanks](/thanks-for-help.md) file. If you're a previous winner we will -add a link to your winning entries in the file (if you're not a previous -winner we can add a link to your GitHub page or personal website if you -have one, should you wish). +[thanks](/thanks-for-help.md) file. If you're the author of an entry +that win the IOCCC, we will add a link to your winning entries in the file +(if you're not an author, we can add a link to your GitHub page or personal +website if you have one, should you wish). If you do fix an entry please feel free to delete the entry from this file! Otherwise if you wish to not worry about it we can do that to make sure the diff --git a/contact.html b/contact.html index 4745d0b56..56d013c1e 100644 --- a/contact.html +++ b/contact.html @@ -121,7 +121,7 @@ href="https://github.com/ioccc-src/winner">ioccc-src/winner repo.If you are trying to:
-
- Report a bug in an IOCCC winner - (see Report a bug in an IOCCC winning entry - (see FAQ 5.1)
- Report an IOCCC web site problem - (see FAQ 5.3)
diff --git a/contact.md b/contact.md index 5c18d7c3a..88b1e271b 100644 --- a/contact.md +++ b/contact.md @@ -13,7 +13,7 @@ of the [ioccc-src/winner repo](https://github.com/ioccc-src/winner). If you are trying to: -* Report a bug in an IOCCC winner - (see [FAQ 5.1](/faq.md#report_bug)) +* Report a bug in an IOCCC winning entry - (see [FAQ 5.1](/faq.md#report_bug)) * Report an IOCCC web site problem - (see [FAQ 5.3](/faq.md#report_web_problem)) * Report a broken or wrong web link - (see [FAQ 5.6](/faq.md#fix_link)) diff --git a/faq.html b/faq.html index bde87ac2f..a99bf4736 100644 --- a/faq.html +++ b/faq.html @@ -134,7 +134,8 @@ href="#faq2">IOCCC Judging process given IOCCC?- 2.1 - What should I put in the remarks.md file of my entry?
-- 2.2 - Why don’t you publish non-winners?
+- 2.2 - Why don’t you publish entries that do not +win?
- 2.3 - How much time does it take to judge the contest?
- 2.4 - How many judging rounds do you @@ -148,32 +149,32 @@ href="#faq3">Compiling and running IOCCC entries
- 3.0 - What Makefile rules are available to build or clean up IOCCC entries?
-- 3.1 - Why doesn’t this IOCCC winner +
- 3.1 - Why doesn’t this IOCCC entry compile?
-- 3.2 - Why does a IOCCC winner fail on my 64-bit +
- 3.2 - Why does a IOCCC entry fail on my 64-bit system?
- 3.3 - Why do some IOCCC entries fail to compile under macOS?
- 3.4 - Why does clang or gcc fail to compile an -IOCCC winner?
+IOCCC entry?- 3.5 - What is this cb tool that is mentioned in the IOCCC?
-- 3.6 - An IOCCC winner messed up my terminal +
.- 3.6 - An IOCCC entry messed up my terminal application, how do I fix this?
-- 3.7 - How do I run an IOCCC winner that requires +
for details.- 3.7 - How do I run an IOCCC entry that requires X11?
-- 3.8 - How do I compile an IOCCC winner that +
for details.- 3.8 - How do I compile an IOCCC entry that requires SDL1 or SDL2?
-- 3.9 - How do I compile an IOCCC winner that +
- 3.9 - How do I compile an IOCCC entry that requires (n)curses?
-- 3.10 - How do I compile and use an IOCCC winner +
- 3.10 - How do I compile and use an IOCCC entry that requires sound?
- 3.11 - Why do Makefiles use -Weverything with clang?
- 3.12 - How do I find out how to send interrupt/EOF etc. for entries that require it?
-- 3.13 - Why does an IOCCC winner fail to compile -or or fail run?
+- 3.13 - Why does an IOCCC entry fail to compile or +or fail run?
- 3.14 - How do I compile and install tcpserver for entries that require it?
- 3.15 - How do I compile and install netpbm for @@ -192,7 +193,7 @@ href="#faq4">Changes made to IOCCC entries incongruent with the winning IOCCC code?
- 4.1 - Why were some calls to the libc function
-gets(3)changed to usefgets(3)?- 4.2 - What was changed in an IOCCC winner source +
- 4.2 - What was changed in an IOCCC entry source code?
- 4.3 - Why do author remarks sometimes not match the source and/or why are there other inconsistencies with the original @@ -205,9 +206,9 @@ href="#faq5">Helping the IOCCC
- 5.2 - How may I submit a fix to an IOCCC -winner?
+entry?- 5.3 - How may I report an IOCCC web site problem?
- 5.4 - How may I submit a fix to the IOCCC web @@ -305,10 +306,11 @@ of the IOCCC, like variety. competition from previous IOCCC entries make it more challenging to be successful.
for details.It is also important to note that the guidelines say:
+href="/guidelines.html">guidelines often state something along the +lines of:-We tend to dislike programs that: are similar to previous -winners
+We tend to dislike programs that: are similar to previous winning +entries
maze generator
@@ -332,8 +334,9 @@ and crosses/Xs and Os game
generating -small primes (below is the list of all prime related winners)
+id="generating-small-primes-below-is-the-list-of-all-prime-related-winning-entries">generating +small primes (below is the list of all prime related winning +entries)
- @@ -506,7 +509,7 @@ include International in the name.
The 1st IOCCC entries were posted on 17 April 1984.
-There were 4 winners in 1984:
+There were 4 entries that won in 1984:
- (dis)honorable @@ -578,7 +581,7 @@ web site.
2020 Dec 28 bzip2 compressed tarball archive
Furthermore, a bzip2 compressed tarball containing the released IOCCC -winner source code may be found under the archive/historic directory. The file archive-all.tar.bz2 contains all years and the individual years are in the form @@ -603,8 +606,8 @@ improvements such as:
- Moving IOCCC entries into their own separate directories
- Fixing lots and lots of typos
-- Fixing Makefiles and code to allow for nearly all winners to be -compiled and work on modern systems
+- Fixing Makefiles and code to allow for nearly all winning entries to +be compiled and work on modern systems
- Reworking the Makefiles to use a consistent set of rules
- Reworking the Makefiles specific to the gcc and clang C compilers
@@ -725,23 +728,23 @@ wins. See the guidelines if this is not clear!leaving the remark section empty.
FAQ -2.2: Why don’t you publish non-winners?
+id="faq-2.2-why-dont-you-publish-entries-that-do-not-win">FAQ +2.2: Why don’t you publish entries that do not win?Because the publication on the IOCCC site IS the award! Anyone is free to put their -IOCCC hopefuls, lookalikes and/or non-winners on their web page for -everyone to see.
+IOCCC hopefuls, lookalikes and/or entries that do not win on their web +page for everyone to see.FAQ 2.3: How much time does it take to judge the contest?
It takes a fair amount of time to setup, run, answer email, process -entries, review entries, trim down the set entries to a set of winners, -doing the write-up of the winners, announcing the winners, reviewing -final edits of the winning entry set, posting the winners, being flamed -:-), tell folks who send in late entries to wait until the next contest, -etc… It takes a few weekends and a number nights of study and work … -which is hard given that we are busy with many other activities as -well.
+entries, review entries, trim down the set entries to a set of winning +entries, doing the write-up of the entries, announcing the entries, +reviewing final edits of the winning entry set, posting the winning +entries, being flamed :-), tell folks who send in late entries to wait +until the next contest, etc… It takes a few weekends and a number nights +of study and work … which is hard given that we are busy with many other +activities as well.Note that we do not contact the author if an entry does not compile or does not work as advertised, we might attempt to fix obvious compilation problems or incompatibilities, but no more than that - so be @@ -762,10 +765,10 @@ actual number of rounds is certainly more than 3.
id="faq-2.5-why-do-some-ioccc-entries-receive-the-grand-prize-or-best-of-show-award">FAQ 2.5: Why do some IOCCC entries receive the Grand Prize or Best of Show award? -In some years, the IOCCC judges discover a truly amazing IOCCC winner +
In some years, the IOCCC judges discover a truly amazing IOCCC entry that stands out among all of the other IOCCC entries received that year. -For such an IOCCC winner, the IOCCC judges award a “Grand Prize” or -“Best of Show award.
+For such an IOCCC entry, the IOCCC judges award a “Grand Prize” or “Best +of Show award.In 1984-1987, the grand prize winners are:
- @@ -807,10 +810,10 @@ closes, the judges will select the winning entries announce them on the @IOCCC mastodon feed, -notify the winners via email using their previously registered email -address, and upload the winning code to the winner repo which in turn -will cause them to be displayed on the winner repo which in +turn will cause them to be displayed on the IOCCC winning entries page.
FAQ -3.1: Why doesn’t this IOCCC winner compile?
-Some winners, particularly winners from long ago, no longer compile -on more modern systems because the C language has evolved (i.e. the -modern C compilers are much more strict in what they accept as a valid -program), or the entry depended on operation system and library features -that where common back then but are different/missing today.
+id="faq-3.1-why-doesnt-this-ioccc-entry-compile">FAQ +3.1: Why doesn’t this IOCCC entry compile? +Some entries that won the IOCCC, particularly entries from long ago, +no longer compile on more modern systems because the C language has +evolved (i.e. the modern C compilers are much more strict in what they +accept as a valid program), or the entry depended on operation system +and library features that where common back then but are +different/missing today.
Please see the other FAQs in this section as they might offer helpful hints, especially in cases were something else needs to be installed.
@@ -876,7 +880,7 @@ design!If you have a fix that makes a minimal impact to the entry, then please consider submitting that change in the form of a pull request. Please see FAQ 5.2 “How may I submit a fix to an -IOCCC winner” for details.
+IOCCC entry”In some cases alternative code has been added that does compile on some or most systems. Check the write up for the entry for “alt” code and possible ways to compile and run that code. In some cases we @@ -886,8 +890,8 @@ the
.orig.cfiles (sometimes the original code is also in the directory as awinner.alt.corprog.alt.c).FAQ -3.2: Why does a IOCCC winner fail on my 64-bit system?
+id="faq-3.2-why-does-a-ioccc-entry-fail-on-my-64-bit-system">FAQ +3.2: Why does a IOCCC entry fail on my 64-bit system?Unfortunately some older entries are non-portable and require 32-bit support or 32-bit binaries. A problem system here is macOS Catalina (10.15) as as of that version macOS no longer supports 32-bit binaries. @@ -912,7 +916,7 @@ fix is wanted, consider trying to port the code to a 64-bit system and submitting a pull request with that change. Pull requests that fix such code while trying to minimize the impact of any changes and preserving the spirit of the original code are very welcome! Please see FAQ 5.2 -“How may I submit a fix to an IOCCC winner” +“How may I submit a fix to an IOCCC entry” for details.
FAQ @@ -927,10 +931,10 @@ known macOS problem with an entry. Should you manage to port the entry, and assuming your changes also attempt to preserve the original intent of the IOCCC entry, we would encourage you to submit a pull request with your ported code. Please see FAQ 5.2 “How may I -submit a fix to an IOCCC winner” for details. +submit a fix to an IOCCC entry”
FAQ -3.4: Why does clang or gcc fail to compile an IOCCC winner?
+id="faq-3.4-why-does-clang-or-gcc-fail-to-compile-an-ioccc-entry">FAQ +3.4: Why does clang or gcc fail to compile an IOCCC entry?Although we have fixed numerous entries to work with clang (sometimes in an alt version but usually in the program itself) there are some that simply cannot be fixed or if they are fixable they have not yet been @@ -950,7 +954,7 @@ you have a change that fixes the problem (even if it just a change to the
+IOCCC entry”Makefile) that doesn’t negatively impact the entry too much, consider submitting that change in the form of a pull request. Please see FAQ 5.2 “How may I submit a fix to an -IOCCC winner” for details.FAQ 3.5: What is this cb tool that is mentioned in the IOCCC?
@@ -961,8 +965,8 @@ seems to no longer be available, code wise, except for Plan 9, but Plan href="https://www.ibm.com/docs/en/aix/7.3?topic=c-cb-command">still existsFAQ -3.6: An IOCCC winner messed up my terminal application, how do I fix +id="faq-3.6-an-ioccc-entry-messed-up-my-terminal-application-how-do-i-fix-this">FAQ +3.6: An IOCCC entry messed up my terminal application, how do I fix this?
The simplest way to do this is to type
reset. If echo was disabled you can get usually away withstty echo. @@ -971,13 +975,13 @@ Sometimes you can also get away withstty sane. (obviouslyclearwill too but it won’t reset the terminal).FAQ -3.7: How do I run an IOCCC winner that requires X11?
+id="faq-3.7-how-do-i-run-an-ioccc-entry-that-requires-x11">FAQ +3.7: How do I run an IOCCC entry that requires X11?Generally, -to compile and run an IOCCC winner that requires X11:
+id="generally-to-compile-and-run-an-ioccc-entry-that-requires-x11">Generally, +to compile and run an IOCCC entry that requires X11:You must have the X11 related include files and X11 libraries in -order to compile the IOCCC winner. In order to do this you will need to +order to compile the IOCCC entry. In order to do this you will need to install Xorg and related packages including development related packages. If you have macOS see further down for different instructions. Otherwise: in particular you must:
@@ -987,7 +991,7 @@ Otherwise: in particular you must:- Install a X11 terminal application.
- Start the Xorg server.
- Launch the X11 terminal application.
-- Run the IOCCC winner in the X11 terminal application.
+- Run the IOCCC entry in the X11 terminal application.
By X11 terminal application we suggest one of:
@@ -1020,7 +1024,7 @@ RHEL, has switched to a Wayland session as it’s default windowing system site for more details.
IMPORTANT NOTE: We do NOT know if IOCCC entries will run under Wayland. Some IOCCC -entries that use X11 might be OK while other IOCCC winners that use X11 +entries that use X11 might be OK while other IOCCC entries that use X11 in an unusual way might fail under Wayland.
See the Wayland FAQ for more information.
@@ -1029,8 +1033,8 @@ give the IOCCC entries that use X11 a try. They might work but again we do not know.IMPORTANT NOTE: The IOCCC judges do not support IOCCC entries. So if -an IOCCC winner that uses X11 fails under Wayland, and -you wish to provide a fix to the IOCCC winner so that it will run under +an IOCCC entry that uses X11 fails under Wayland, and +you wish to provide a fix to the IOCCC entry so that it will run under Wayland, then consider submitting a fix so that it will run under Wayland.
@@ -1055,7 +1059,7 @@ server has been deprecated. See the above note for details. starting Xorg. However, for macOS, instead of installing the Xorg server, you need to install and launch the most recent XQuartz application and -then run the IOCCC winner from the Xterm window shell.As an example we will use 1993/jonth which works with macOS @@ -1131,8 +1135,8 @@ site.
IMPORTANT NOTE: The X.org server has been deprecated. See the above note for details.
FAQ -3.8: How do I compile an IOCCC winner that requires SDL1 or SDL2?
+id="faq-3.8-how-do-i-compile-an-ioccc-entry-that-requires-sdl1-or-sdl2">FAQ +3.8: How do I compile an IOCCC entry that requires SDL1 or SDL2?This depends on your operating system but below are instructions for Linux and macOS with alternative methods for macOS and different package managers with Linux.
@@ -1203,8 +1207,8 @@ installed it might be that you need additional SDL libraries. See the entry’s README.md for details. If something is not noted you’re welcome to report it as an issue or fix it and make a new pull request.FAQ -3.9: How do I compile an IOCCC winner that requires (n)curses?
+id="faq-3.9-how-do-i-compile-an-ioccc-entry-that-requires-ncurses">FAQ +3.9: How do I compile an IOCCC entry that requires (n)curses?This depends on your operating system but below are instructions for Linux and macOS with alternative methods for macOS and different package managers with Linux.
@@ -1241,8 +1245,8 @@ and using ncurses.We recommend trying a method suitable for your environment first, if possible.
FAQ -3.10: How do I compile and use an IOCCC winner that requires sound?
+id="faq-3.10-how-do-i-compile-and-use-an-ioccc-entry-that-requires-sound">FAQ +3.10: How do I compile and use an IOCCC entry that requires sound?This might depend on the entry but most likely the Swiss Army Knife of sound processing programs, SoX, will work. How to install @@ -1278,7 +1282,7 @@ id="faq-3.10-why-do-makefiles-use--weverything-with-clang">
While we know that use of
-Weverythingis generally not recommended byclangC compiler developers, we do use the --Weverythingoption in a certain case in IOCCC winner +-Weverythingoption in a certain case in IOCCC entryMakefiles.The use of
-Weverythingis limited to when one forcesCC=clangor more generally if the string ‘clang’ is in @@ -1398,12 +1402,12 @@ class="sourceCode sh">FAQ -3.13: Why does an IOCCC winner fail to compile or or fail run? +id="faq-3.13-why-does-an-ioccc-entry-fail-to-compile-or-or-fail-run">FAQ +3.13: Why does an IOCCC entry fail to compile or or fail run?What may have worked years ago may not work well or work at all today. Please note that the IOCCC judges do NOT support IOCCC entries. Nevertheless, there may be a number of reasons why an -IOCCC winner may fail to compile or run well or fail to run on your +IOCCC entry may fail to compile or run well or fail to run on your system.
In some cases the American National Standards Institute’s ANSI C committee has damaged the C standard to the point where perfectly valid @@ -1415,21 +1419,21 @@ no longer work on modern computers or modern operating systems. Some IOCCC entries fail to compile under clang, or gcc. Some IOCCC entries require operating system services that may not be present on your system.
-In some cases the IOCCC winner simply has bugs or (Mis)features.
-If you are having problems compiling or running an IOCCC winner, we +
In some cases the IOCCC entry simply has bugs or (Mis)features.
+If you are having problems compiling or running an IOCCC entry, we recommend that you look in bugs.md to see if there is a known bugs or (Mis)feature. In some cases what you may think is a bug is actually an feature that was intentionally written by the authors. In some cases the problem is well known and we are looking for someone to attempt to fix it.
-In some cases there is an alternate version of the IOCCC winner that +
In some cases there is an alternate version of the IOCCC entry that you may wish to try.
It also possible that you may have discovered a bug in an IOCCC -winner. If so, you are invited to try an fix the IOCCC winner and submit +winner. If so, you are invited to try an fix the IOCCC entry and submit that fix by way of a GitHub pull request. Please see FAQ 5.2 for how to submit -a fix to an IOCCC winner.
+a fix to an IOCCC entry.FAQ 3.14 - How do I compile and install tcpserver for entries that require @@ -1591,7 +1595,7 @@ id="how-do-i-compile-and-install-opengl-for-entries-that-require-it">FAQ 3.7: How do I run an IOCCC -winner that requires X11? for general information about X11. +entry that requires X11? for general information about X11.
Once X11 is install and the X Window Server is running, one needs to compile and link with the two libraries, GL and GLU:
@@ -1718,8 +1722,8 @@ name of backward compatibility. a problem and it is this that has complicated most of the fixes though again some can look almost identical.FAQ -4.2: What was changed in an IOCCC winner source code?
+id="faq-4.2-what-was-changed-in-an-ioccc-entry-source-code">FAQ +4.2: What was changed in an IOCCC entry source code?We have set up make rules to easily do see what was changed in the IOCCC winner source. Using the
@@ -1834,7 +1838,7 @@ cases, such asMakefilein the winner directory, use one of the following make(1) rules:1984/mullender, the original code is the same as the code as no changes were made (there is an alt version for systems that are not VAX-11/PDP-11, however).See also FAQ 4.2: What was changed in an IOCCC -winner source code?
+entry source code?FAQ 4.4: What is the meaning of the file ending in .orig.c in IOCCC @@ -1852,12 +1856,12 @@ id="faq-5.0-how-may-i-help-the-ioccc">
+The known bugs file, order by IOCCC years, contains a list of known bugs & (mis)features. If you are looking -for an IOCCC winner to try and fix, this file is a good place to +for an IOCCC entry to try and fix, this file is a good place to start.
See FAQ 5.2 for information on how to submit a -fix to an IOCCC winner. Before you consider trying to fix an IOCCC +fix to an IOCCC entry. Before you consider trying to fix an IOCCC winner, please check the known bugs file for the -IOCCC winner in question. Note that in several cases what you may have +IOCCC entry in question. Note that in several cases what you may have discovered, 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 file section may offer you @@ -1865,9 +1869,9 @@ important fixing clues.
We welcome your help on fixing the IOCCC web site
FAQ -5.1: How do I report a bug in an IOCCC winner?
-We do not ‘maintain’ the contest winners as such. The code is made +id="faq-5.1-how-do-i-report-a-bug-in-an-ioccc-entry">FAQ +5.1: How do I report a bug in an IOCCC entry?
We do not ‘maintain’ the contest entries as such. The code is made available on an ‘AS IS’ basis. If you have a FIX for an entry, we suggest that you submit your fixes in a GitHub pull @@ -1875,7 +1879,7 @@ request as we welcome pull requests that have a minimal impact on the entry while improving the portability, functionality, and/or addressing known problems.
If you do submit a pull request, we ask that each pull request -address just one IOCCC winner at a time.
+address just one IOCCC entry at a time.Note that just because you have a fix does not mean it’ll be accepted. This might be because the author objects or it doesn’t fit in some way or another. Of course if the entry does not work we’ll @@ -1886,8 +1890,8 @@ if you’re not we can link to your website if you wish.
See FAQ 5.2 for information on how to submit a fix to an IOCCC entry.
FAQ -5.2: How may I submit a fix to an IOCCC winner?
+id="faq-5.2-how-may-i-submit-a-fix-to-an-ioccc-entry">FAQ +5.2: How may I submit a fix to an IOCCC entry?If you see a problem with an IOCCC entry, first check the known bugs file. In some cases what you might think of as a bug is instead a known feature. In some cases the bug is known, @@ -1903,7 +1907,7 @@ href="https://github.com/ioccc-src/winner">ioccc-src/winner repo.
BTW: A problem is not limited to the code itself. Fixing typos in files such as “README.md” files, fixing issues -in a “Makefile”, or otherwise correcting an IOCCC winner is +in a “Makefile”, or otherwise correcting an IOCCC entry is VERY MUCH WELCOME! Please use the same GitHub pull request process against the master write-up of how IOCCC winning entries are presented!
In any event we will happily add you to the thanks file for your help!
-And of course, an IOCCC winner may update their own entries (metadata +
And of course, an IOCCC entry may update their own entries (metadata as well as source code and any extra files) by opening a GitHub pull request against the master id="faq-5.3-how-may-i-report-an-ioccc-web-site-problem">FAQ 5.3: How may I report an IOCCC web site problem?
If you discover a problem with the IOCCC web site that is related to -a particular IOCCC winner, please see FAQ 5.1 for -information about reporting a bug in an IOCCC winner, and see FAQ 5.1 for +information about reporting a bug in an IOCCC entry, and see FAQ 5.2 for information on how to submit a fix to an -IOCCC winner.
+IOCCC entry.If you discover a problem with the IOCCC web site (such as a broken -link, which may or may not be specific to a particular IOCCC winner) -that is not related to a particular IOCCC winner, the -best way you can help is to submit a fix to the IOCCC web site. See not related to a particular IOCCC entry, the best +way you can help is to submit a fix to the IOCCC web site. See FAQ 5.4 for information on submitting fixes to the IOCCC web site.
If you do not have a IOCCC web site fix, and just wish to report a @@ -1949,9 +1953,9 @@ href="//github.com/ioccc-src/winner/issues">new IOCCC issue.
FAQ 5.4: How may I submit a fix to the IOCCC web site?
-For IOCCC web site problems that relate to a particular IOCCC winner, +
For IOCCC web site problems that relate to a particular IOCCC entry, please see FAQ 5.2 for information on how submit a -fix to an IOCCC winner.
+fix to an IOCCC entry.You may open a GitHub pull request against the master href="https://github.com/ioccc-src/build-ioccc">build-ioccc repo to help build HTML content for the official IOCCC web site. For example, the
index.htmlfile for -each IOCCC winner contains selected information about the authors. Tools +each IOCCC entry contains selected information about the authors. Tools from the build-ioccc repo use the content of these JSON files to generate theindex.htmlfiles for each IOCCC winning entry.Moreover, should the IOCCC judges need to -contact an authors of a IOCCC winner, they will consult the contents of +contact an authors of a IOCCC entry, they will consult the contents of the author’s JSON file for ways to contact them.
Each author of an IOCCC winning entry has their own
@@ -2599,10 +2603,10 @@ id="faq-6.8-what-is-the-purpose-of-the-.top-.year-and-.path-files">.top file resides at the top directory. This file contains the complete list of IOCCC years.author_handle.jsonfile of the form:Under each IOCCC year. one will find a
-.yearfile. These -files contain directory paths from the top directory, of the IOCCC -winner directories for a given year. For example, see the 1984/.year file.Under each IOCCC winner directory, you will find a
.path+Under each IOCCC entry directory, you will find a
diff --git a/faq.md b/faq.md index 4e5a403fe..182e80f0c 100644 --- a/faq.md +++ b/faq.md @@ -16,7 +16,7 @@ ## Section 2 - [IOCCC Judging process](#faq2) - [2.0 - How many entries do the judges receive for a given IOCCC?](#faq2_0) - [2.1 - What should I put in the remarks.md file of my entry?](#faq2_1) -- [2.2 - Why don't you publish non-winners?](#faq2_2) +- [2.2 - Why don't you publish entries that do not win?](#faq2_2) - [2.3 - How much time does it take to judge the contest?](#faq2_3) - [2.4 - How many judging rounds do you have?](#faq2_4) - [2.5 - Why do some IOCCC entries receive the Grand Prize or Best of Show award?](#faq2_5) @@ -24,19 +24,19 @@ ## Section 3 - [Compiling and running IOCCC entries](#faq3) - [3.0 - What Makefile rules are available to build or clean up IOCCC entries?](#faq3_0) -- [3.1 - Why doesn't this IOCCC winner compile?](#faq3_1) -- [3.2 - Why does a IOCCC winner fail on my 64-bit system?](#faq3_2) +- [3.1 - Why doesn't this IOCCC entry compile?](#faq3_1) +- [3.2 - Why does a IOCCC entry fail on my 64-bit system?](#faq3_2) - [3.3 - Why do some IOCCC entries fail to compile under macOS?](#faq3_3) -- [3.4 - Why does clang or gcc fail to compile an IOCCC winner?](#faq3_4) +- [3.4 - Why does clang or gcc fail to compile an IOCCC entry?](#faq3_4) - [3.5 - What is this cb tool that is mentioned in the IOCCC?](#faq3_5) -- [3.6 - An IOCCC winner messed up my terminal application, how do I fix this?](#faq3_6) -- [3.7 - How do I run an IOCCC winner that requires X11?](#faq3_7) -- [3.8 - How do I compile an IOCCC winner that requires SDL1 or SDL2?](#faq3_8) -- [3.9 - How do I compile an IOCCC winner that requires (n)curses?](#faq3_9) -- [3.10 - How do I compile and use an IOCCC winner that requires sound?](#faq3_10) +- [3.6 - An IOCCC entry messed up my terminal application, how do I fix this?](#faq3_6) +- [3.7 - How do I run an IOCCC entry that requires X11?](#faq3_7) +- [3.8 - How do I compile an IOCCC entry that requires SDL1 or SDL2?](#faq3_8) +- [3.9 - How do I compile an IOCCC entry that requires (n)curses?](#faq3_9) +- [3.10 - How do I compile and use an IOCCC entry that requires sound?](#faq3_10) - [3.11 - Why do Makefiles use -Weverything with clang?](#faq3_11) - [3.12 - How do I find out how to send interrupt/EOF etc. for entries that require it?](#faq3_12) -- [3.13 - Why does an IOCCC winner fail to compile or or fail run?](#faq3_13) +- [3.13 - Why does an IOCCC entry fail to compile or or fail run?](#faq3_13) - [3.14 - How do I compile and install tcpserver for entries that require it?](#faq3_14) - [3.15 - How do I compile and install netpbm for entries that require it?](#faq3_15) - [3.16 - How do I compile and install libjpeg-turbo for entries that require it?](#faq3_16) @@ -47,15 +47,15 @@ ## Section 4 - [Changes made to IOCCC entries](#faq4) - [4.0 - Why are some winning author remarks incongruent with the winning IOCCC code?](#faq4_0) - [4.1 - Why were some calls to the libc function `gets(3)` changed to use `fgets(3)`?](#faq4_1) -- [4.2 - What was changed in an IOCCC winner source code?](#faq4_2) +- [4.2 - What was changed in an IOCCC entry source code?](#faq4_2) - [4.3 - Why do author remarks sometimes not match the source and/or why are there other inconsistencies with the original entry?](#faq4_3) - [4.4 - What is the meaning of the file ending in .orig.c in IOCCC entries?](#faq4_4) ## Section 5 - [Helping the IOCCC](#faq5) - [5.0 - How may I help the IOCCC?](#faq5_0) -- [5.1 - How do I report a bug in an IOCCC winner?](#faq5_1) -- [5.2 - How may I submit a fix to an IOCCC winner?](#faq5_2) +- [5.1 - How do I report a bug in an IOCCC entry?](#faq5_1) +- [5.2 - How may I submit a fix to an IOCCC entry?](#faq5_2) - [5.3 - How may I report an IOCCC web site problem?](#faq5_3) - [5.4 - How may I submit a fix to the IOCCC web site?](#faq5_4) - [5.5 - How may I correct or update IOCCC author information?](#faq5_5) @@ -170,9 +170,10 @@ __over-submitted__ types of entries, level of the competition from previous IOCCC entries make it more challenging to be successful. -It is also important to note that the [guidelines](/guidelines.html) say: +It is also important to note that the [guidelines](/guidelines.html) often +state something along the lines of: -> _We tend to dislike programs that: are similar to previous winners_ +> _We tend to dislike programs that: are similar to previous winning entries_ #### maze generator @@ -203,7 +204,7 @@ It is also important to note that the [guidelines](/guidelines.html) say: - [1994/dodsond1](/years.html#1994_dodsond1) -#### generating small primes (below is the list of all prime related winners) +#### generating small primes (below is the list of all prime related winning entries) - [1985/august](/years.html#1985_august) @@ -416,7 +417,7 @@ The [1st IOCCC entries](http://groups.google.com/groups?q=Obfuscated&hl=en&lr=&ie=UTF-8&as_drrb=b&as_mind=1&as_minm=1&as_miny=1983&as_maxd=18&as_maxm=4&as_maxy=1984&selm=837%40nsc.UUCP&rnum=2&filter=0) were posted on 17 April 1984. -There were 4 winners in 1984: +There were 4 entries that won in 1984: 1. [(dis)honorable mention](http://groups.google.com/groups?q=Obfuscated&hl=en&lr=&ie=UTF-8&as_drrb=b&as_mind=1&as_minm=1&as_miny=1983&as_maxd=18&as_maxm=4&as_maxy=1984&selm=842%40nsc.UUCP&rnum=8&filter=0) 2. [3rd place](http://groups.google.com/groups?q=Obfuscated&hl=en&lr=&ie=UTF-8&as_drrb=b&as_mind=1&as_minm=1&as_miny=1983&as_maxd=18&as_maxm=4&as_maxy=1984&selm=843%40nsc.UUCP&rnum=7&filter=0) @@ -480,7 +481,7 @@ web site. #### 2020 Dec 28 bzip2 compressed tarball archive Furthermore, a bzip2 compressed tarball containing the released -IOCCC winner source code may be found under the +IOCCC entry source code may be found under the [archive/historic](/archive/histroic) directory. The file [archive-all.tar.bz2](/archive/historic/archive-all.tar.bz2) contains all years and the individual years are in the form @@ -506,7 +507,7 @@ changes and important improvements such as: * Moving IOCCC entries into their own separate directories * Fixing lots and lots of typos -* Fixing Makefiles and code to allow for nearly all winners to be compiled and +* Fixing Makefiles and code to allow for nearly all winning entries to be compiled and work on modern systems * Reworking the Makefiles to use a consistent set of rules * Reworking the Makefiles specific to the gcc and clang C compilers @@ -635,19 +636,19 @@ this is not clear! - leaving the remark section empty. -### FAQ 2.2: Why don't you publish non-winners? +### FAQ 2.2: Why don't you publish entries that do not win? Because the publication on the IOCCC site **_IS_** the award! Anyone is free to put their IOCCC hopefuls, lookalikes and/or -non-winners on their web page for everyone to see. +entries that do not win on their web page for everyone to see. ### FAQ 2.3: How much time does it take to judge the contest? It takes a fair amount of time to setup, run, answer email, process entries, -review entries, trim down the set entries to a set of winners, doing the -write-up of the winners, announcing the winners, reviewing final edits of the -winning entry set, posting the winners, being flamed :-), tell folks who send in +review entries, trim down the set entries to a set of winning entries, doing the +write-up of the entries, announcing the entries, reviewing final edits of the +winning entry set, posting the winning entries, being flamed :-), tell folks who send in late entries to wait until the next contest, etc... It takes a few weekends and a number nights of study and work ... which is hard given that we are busy with many other activities as well. @@ -672,9 +673,9 @@ sometimes we also report when we enter what we believe is the final judging roun ### FAQ 2.5: Why do some IOCCC entries receive the Grand Prize or Best of Show award? -In some years, the IOCCC judges discover a truly amazing IOCCC winner that +In some years, the IOCCC judges discover a truly amazing IOCCC entry that stands out among all of the other IOCCC entries received that year. -For such an IOCCC winner, the IOCCC judges award a "Grand Prize" +For such an IOCCC entry, the IOCCC judges award a "Grand Prize" or "Best of Show award. In 1984-1987, the grand prize winners are: @@ -727,9 +728,9 @@ more other entries that came in close behind. Once the [IOCCC](https://www.ioccc.org/index.html#enter) closes, the judges will select the [winning entries](https://www.ioccc.org/years.html) announce them -on the [@IOCCC mastodon feed](https://fosstodon.org/@ioccc), notify the winners -via email using their previously registered email address, and upload the -winning code to the [winner repo](https://github.com/ioccc-src/winner) +on the [@IOCCC mastodon feed](https://fosstodon.org/@ioccc), notify the authors +of entries that won the IOCCC via email using their previously registered email address, +and upload the winning code to the [winner repo](https://github.com/ioccc-src/winner) which in turn will cause them to be displayed on the [IOCCC winning entries page](https://www.ioccc.org/years.html). @@ -789,9 +790,9 @@ enable or disable additional warnings or flags. Even so different versions or compilers might do different things, have different defects or other issues. -### FAQ 3.1: Why doesn't this IOCCC winner compile? +### FAQ 3.1: Why doesn't this IOCCC entry compile? -Some winners, particularly winners from long ago, no longer compile on more +Some entries that won the IOCCC, particularly entries from long ago, no longer compile on more modern systems because the C language has evolved (i.e. the modern C compilers are much more strict in what they accept as a valid program), or the entry depended on operation system and library features that where common back then @@ -803,7 +804,7 @@ hints, especially in cases were something else needs to be installed. Please see the [bugs.md](/bugs.md) file for details about known problems with IOCCC entries. In some cases you may be dealing with a problematic entry. In a few fun cases, the IOCCC does not compile by design! If you have a fix that makes a minimal impact to the entry, then please consider submitting that change in the form of a pull request. Please -see FAQ 5.2 "How may I submit a fix to an IOCCC winner" for details. +see FAQ 5.2 "How may I submit a fix to an IOCCC entry" for details. In some cases alternative code has been added that does compile on some or most systems. Check the write up for the entry for "alt" code and possible ways to compile and run that code. In some cases we replaced the original code (but not the `.orig.c` file!) with code that works for modern systems but one can view the original code in the @@ -811,7 +812,7 @@ that works for modern systems but one can view the original code in the `winner.alt.c` or `prog.alt.c`). -### FAQ 3.2: Why does a IOCCC winner fail on my 64-bit system? +### FAQ 3.2: Why does a IOCCC entry fail on my 64-bit system? Unfortunately some older entries are non-portable and require 32-bit support or 32-bit binaries. A problem system here is macOS Catalina (10.15) as as of that @@ -833,7 +834,7 @@ now work with 32-bit AND 64-bit systems. Please see the [bugs.md](/bugs.md) file for the problematic entry in question to see if the problem is known, and if a fix is wanted, consider trying to port the code to a 64-bit system and submitting a pull request with that change. Pull requests that fix such code while trying to minimize the impact of any changes and preserving the spirit of the original code are very welcome! Please -see FAQ 5.2 "How may I submit a fix to an IOCCC winner" for details. +see FAQ 5.2 "How may I submit a fix to an IOCCC entry" for details. ### FAQ 3.3: Why do some IOCCC entries fail to compile under macOS? @@ -847,10 +848,10 @@ others will be looked at, when found. In some cases the [bugs.md](/bugs.md) file may note a known macOS problem with an entry. Should you manage to port the entry, and assuming your changes also attempt to preserve the original intent of the IOCCC entry, we would encourage you to submit a pull request with your ported code. Please -see FAQ 5.2 "How may I submit a fix to an IOCCC winner" for details. +see FAQ 5.2 "How may I submit a fix to an IOCCC entry" for details. -### FAQ 3.4: Why does clang or gcc fail to compile an IOCCC winner? +### FAQ 3.4: Why does clang or gcc fail to compile an IOCCC entry? Although we have fixed numerous entries to work with clang (sometimes in an alt version but usually in the program itself) there are some that simply cannot be @@ -868,7 +869,7 @@ other things that have to be done plus remembering to do it. See if the problem is mentioned in [bugs.md](/bugs.md). If you have a change that fixes the problem (even if it just a change to the `Makefile`) that doesn't negatively impact the entry too much, consider submitting that change in the form of a pull request. Please -see FAQ 5.2 "How may I submit a fix to an IOCCC winner" for details. +see FAQ 5.2 "How may I submit a fix to an IOCCC entry" for details. ### FAQ 3.5: What is this cb tool that is mentioned in the IOCCC? @@ -879,7 +880,7 @@ judging the IOCCC. A Unix man page for `cb` [still exists](https://www.ibm.com/docs/en/aix/7.3?topic=c-cb-command). -### FAQ 3.6: An IOCCC winner messed up my terminal application, how do I fix this? +### FAQ 3.6: An IOCCC entry messed up my terminal application, how do I fix this? The simplest way to do this is to type `reset`. If echo was disabled you can get usually away with `stty echo`. Sometimes you can also get away with `stty sane`. @@ -887,13 +888,13 @@ usually away with `stty echo`. Sometimes you can also get away with `stty sane`. will too but it won't reset the terminal). -### FAQ 3.7: How do I run an IOCCC winner that requires X11? +### FAQ 3.7: How do I run an IOCCC entry that requires X11? -#### Generally, to compile and run an IOCCC winner that requires X11: +#### Generally, to compile and run an IOCCC entry that requires X11: You must have the X11 related include files and X11 libraries in order to -compile the IOCCC winner. In order to do this you will need to install Xorg and +compile the IOCCC entry. In order to do this you will need to install Xorg and related packages including development related packages. If you have macOS see further down for different instructions. Otherwise: in particular you must: @@ -902,7 +903,7 @@ further down for different instructions. Otherwise: in particular you must: * Install a X11 terminal application. * Start the Xorg server. * Launch the X11 terminal application. -* Run the IOCCC winner in the X11 terminal application. +* Run the IOCCC entry in the X11 terminal application. By X11 terminal application we suggest one of: @@ -936,7 +937,7 @@ See the [Wayland](https://wayland.freedesktop.org) web site for more details. **IMPORTANT NOTE**: We do **NOT** know if IOCCC entries will run under **Wayland**. Some IOCCC entries that use X11 might be OK while other IOCCC -winners that use X11 in an unusual way might fail under **Wayland**. +entries that use X11 in an unusual way might fail under **Wayland**. See the [Wayland FAQ](https://wayland.freedesktop.org/faq.html) for more @@ -946,8 +947,8 @@ If your system uses **Wayland** and not X11, you might give the IOCCC entries that use X11 a try. They might work but again we do not know. **IMPORTANT NOTE**: The [IOCCC judges](/judges.html) [do not support IOCCC entries](#no_support). -So if an IOCCC winner that uses X11 fails under **Wayland**, and you wish to -provide a fix to the IOCCC winner so that it will run under **Wayland**, +So if an IOCCC entry that uses X11 fails under **Wayland**, and you wish to +provide a fix to the IOCCC entry so that it will run under **Wayland**, then consider [submitting a fix](#fix_an_entry) so that it will run under **Wayland**. Basically: if you discover an entry does not work in Wayland you are welcome to @@ -978,7 +979,7 @@ See the above note for details. First, see the above note on [installing and starting Xorg](#X11_general). However, for macOS, instead of installing the Xorg server, you need to install and launch the [most recent XQuartz](https://www.xquartz.org) application -and then run the IOCCC winner from the [Xterm window +and then run the IOCCC entry from the [Xterm window shell](https://en.wikipedia.org/wiki/Xterm). As an example we will use [1993/jonth](/1993/jonth/README.md) which works @@ -1074,7 +1075,7 @@ See the [X.org](https://x.org/wiki/) foundation web site. See the above note for details. -### FAQ 3.8: How do I compile an IOCCC winner that requires SDL1 or SDL2? +### FAQ 3.8: How do I compile an IOCCC entry that requires SDL1 or SDL2? This depends on your operating system but below are instructions for Linux and macOS with alternative methods for macOS and different package managers with Linux. @@ -1189,7 +1190,7 @@ details. If something is not noted you're welcome to report it as an issue or fix it and make a new pull request. -### FAQ 3.9: How do I compile an IOCCC winner that requires (n)curses? +### FAQ 3.9: How do I compile an IOCCC entry that requires (n)curses? This depends on your operating system but below are instructions for Linux and macOS with alternative methods for macOS and different package managers with Linux. @@ -1252,7 +1253,7 @@ for downloading, installing and using ncurses. We recommend trying a method suitable for your environment first, if possible. -### FAQ 3.10: How do I compile and use an IOCCC winner that requires sound? +### FAQ 3.10: How do I compile and use an IOCCC entry that requires sound? This might depend on the entry but most likely the Swiss Army Knife of sound processing programs, [SoX](https://sox.sourceforge.net), will work. How to @@ -1314,7 +1315,7 @@ include this here, at least for now. While we know that use of `-Weverything` is generally not recommended by `clang` C compiler developers, we do use the `-Weverything` -option in a certain case in IOCCC winner `Makefile`s. +option in a certain case in IOCCC entry `Makefile`s. The use of `-Weverything` is limited to when one forces `CC=clang` or more generally if the string 'clang' is in `$(CC)`. If `$(CC)` contains 'gcc' the @@ -1446,11 +1447,11 @@ reason it's not you might have to do something else including just piping it to just `grep intr` or whatever. -### FAQ 3.13: Why does an IOCCC winner fail to compile or or fail run? +### FAQ 3.13: Why does an IOCCC entry fail to compile or or fail run? What may have worked years ago may not work well or work at all today. Please note that the IOCCC judges do **NOT** support IOCCC entries. -Nevertheless, there may be a number of reasons why an IOCCC winner +Nevertheless, there may be a number of reasons why an IOCCC entry may fail to compile or run well or fail to run on your system. In some cases the American National Standards Institute's ANSI C @@ -1465,23 +1466,23 @@ Some IOCCC entries fail to compile under clang, or gcc. Some IOCCC entries require operating system services that may not be present on your system. -In some cases the IOCCC winner simply has bugs or (Mis)features. +In some cases the IOCCC entry simply has bugs or (Mis)features. -If you are having problems compiling or running an IOCCC winner, +If you are having problems compiling or running an IOCCC entry, we recommend that you look in [bugs.md](/bugs.md) to see if there is a known bugs or (Mis)feature. In some cases what you may think is a bug is actually an feature that was intentionally written by the authors. In some cases the problem is well known and we are looking for someone to attempt to fix it. -In some cases there is an alternate version of the IOCCC winner +In some cases there is an alternate version of the IOCCC entry that you may wish to try. It also possible that you may have discovered a bug in an IOCCC -winner. If so, you are invited to try an fix the IOCCC winner and +winner. If so, you are invited to try an fix the IOCCC entry and submit that fix by way of a [GitHub pull request](https://github.com/ioccc-src/temp-test-ioccc/pulls). -Please see [FAQ 5.2](#faq5_2) for how to submit a fix to an IOCCC winner. +Please see [FAQ 5.2](#faq5_2) for how to submit a fix to an IOCCC entry. ### FAQ 3.14 - How do I compile and install tcpserver for entries that require it? @@ -1741,7 +1742,7 @@ We recommend trying a method suitable for your environment first, if possible. This depends on your operating system for which we describe a couple below. In general OpenGL needs X11 to be installed and the X Window Server to be running. -See [FAQ 3.7: How do I run an IOCCC winner that requires X11?](#X11_general) for +See [FAQ 3.7: How do I run an IOCCC entry that requires X11?](#X11_general) for general information about X11. Once X11 is install and the X Window Server is running, one needs to compile @@ -1890,7 +1891,7 @@ can look almost identical. -### FAQ 4.2: What was changed in an IOCCC winner source code? +### FAQ 4.2: What was changed in an IOCCC entry source code? We have set up make rules to easily do see what was changed in the IOCCC winner source. Using the `Makefile` in the winner directory, use @@ -2005,7 +2006,7 @@ some cases, such as `1984/mullender`, the original code is the same as the code as no changes were made (there is an alt version for systems that are not VAX-11/PDP-11, however). -See also [FAQ 4.2: What was changed in an IOCCC winner source code?](#faq4_2) +See also [FAQ 4.2: What was changed in an IOCCC entry source code?](#faq4_2) ### FAQ 4.4: What is the meaning of the file ending in .orig.c in IOCCC entries? @@ -2023,12 +2024,12 @@ we can find. ### We welcome your help in fixing IOCCC entries The [known bugs](/bugs.md) file, order by IOCCC years, contains a -list of known bugs & (mis)features. If you are looking for an IOCCC winner +list of known bugs & (mis)features. If you are looking for an IOCCC entry to try and fix, this file is a good place to start. See [FAQ 5.2](#faq5_2) for information on how to submit a fix to -an IOCCC winner. Before you consider trying to fix an IOCCC winner, -please check the [known bugs](/bugs.md) file for the IOCCC winner +an IOCCC entry. Before you consider trying to fix an IOCCC winner, +please check the [known bugs](/bugs.md) file for the IOCCC entry in question. Note that in several cases what you may have discovered, 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.md) file @@ -2037,14 +2038,14 @@ section may offer you important fixing clues. ### We welcome your help on fixing the IOCCC web site -### FAQ 5.1: How do I report a bug in an IOCCC winner? +### FAQ 5.1: How do I report a bug in an IOCCC entry? -We do not 'maintain' the contest winners as such. The code is made available on an 'AS +We do not 'maintain' the contest entries as such. The code is made available on an 'AS IS' basis. If you have a FIX for an entry, we suggest that you submit your fixes in a [GitHub pull request](https://github.com/ioccc-src/temp-test-ioccc/pulls) as we welcome pull requests that have a minimal impact on the entry while improving the portability, functionality, and/or addressing known problems. -If you do submit a pull request, we ask that each pull request address just one IOCCC winner at a time. +If you do submit a pull request, we ask that each pull request address just one IOCCC entry at a time. Note that just because you have a fix does not mean it'll be accepted. This might be because the author objects or it doesn't fit in some way or another. Of @@ -2056,7 +2057,7 @@ link to your entries; if you're not we can link to your website if you wish. See [FAQ 5.2](#faq5_2) for information on how to submit a fix to an IOCCC entry. -### FAQ 5.2: How may I submit a fix to an IOCCC winner? +### FAQ 5.2: How may I submit a fix to an IOCCC entry? If you see a problem with an IOCCC entry, first check the [known bugs](/bugs.md) file. In some cases what you might think of as a bug is instead a known @@ -2071,7 +2072,7 @@ repo](https://github.com/ioccc-src/winner). BTW: A **problem** is not limited to the code itself. Fixing typos in files such as "_README.md_" files, fixing issues in a "_Makefile_", or otherwise -correcting an IOCCC winner is **VERY MUCH WELCOME**! Please use the same +correcting an IOCCC entry is **VERY MUCH WELCOME**! Please use the same [GitHub pull request](https://github.com/ioccc-src/winner/pulls) process against the master [branch](https://github.com/ioccc-src/winner/branches) of the [ioccc-src/winner repo](https://github.com/ioccc-src/winner). @@ -2085,7 +2086,7 @@ IOCCC winning entries are presented! In any event we will happily add you to the [thanks](/thanks-for-help.md) file for your help! -And of course, an IOCCC winner may update their own entries +And of course, an IOCCC entry may update their own entries (metadata as well as source code and any extra files) by opening a [GitHub pull request](https://github.com/ioccc-src/winner/pulls) against the master [branch](https://github.com/ioccc-src/winner/branches) @@ -2098,13 +2099,13 @@ have the final say in the matter. ### FAQ 5.3: How may I report an IOCCC web site problem? If you discover a problem with the IOCCC web site that is related -to a particular IOCCC winner, please see [FAQ 5.1](#faq5_1) for -information about reporting a bug in an IOCCC winner, and see [FAQ -5.2](#faq5_2) for information on how to submit a fix to an IOCCC winner. +to a particular IOCCC entry, please see [FAQ 5.1](#faq5_1) for +information about reporting a bug in an IOCCC entry, and see [FAQ +5.2](#faq5_2) for information on how to submit a fix to an IOCCC entry. If you discover a problem with the IOCCC web site (such as a broken link, which -may or may not be specific to a particular IOCCC winner) that is **not related -to a particular IOCCC winner**, the best way you can help is to submit a fix to +may or may not be specific to a particular IOCCC entry) that is **not related +to a particular IOCCC entry**, the best way you can help is to submit a fix to the IOCCC web site. See [FAQ 5.4](#faq5_4) for information on submitting fixes to the IOCCC web site. @@ -2119,8 +2120,8 @@ issue](//github.com/ioccc-src/winner/issues). ### FAQ 5.4: How may I submit a fix to the IOCCC web site? -For IOCCC web site problems that relate to a particular IOCCC winner, please -see [FAQ 5.2](#faq5_2) for information on how submit a fix to an IOCCC winner. +For IOCCC web site problems that relate to a particular IOCCC entry, please +see [FAQ 5.2](#faq5_2) for information on how submit a fix to an IOCCC entry. You may open a [GitHub pull request](https://github.com/ioccc-src/winner/pulls) against the master [branch](https://github.com/ioccc-src/winner/branches) @@ -2392,14 +2393,14 @@ HTML files as well to contact an author. The content of these JSON files are used by tools from the [build-ioccc repo](https://github.com/ioccc-src/build-ioccc) to help build HTML content for the [official IOCCC web site](https://www.ioccc.org). -For example, the `index.html` file for each IOCCC winner contains +For example, the `index.html` file for each IOCCC entry contains selected information about the authors. Tools from the [build-ioccc repo](https://github.com/ioccc-src/build-ioccc) use the content of these JSON files to generate the `index.html` files for each IOCCC winning entry. Moreover, should the [IOCCC judges](/judges.html) need to -contact an authors of a IOCCC winner, they will consult the contents +contact an authors of a IOCCC entry, they will consult the contents of the author's JSON file for ways to contact them. Each author of an IOCCC winning entry has their own `author_handle.json` file @@ -2929,9 +2930,9 @@ The [.top](/.top) file resides at the top directory. This file contains the com of IOCCC years. Under each IOCCC year. one will find a `.year` file. These files contain directory paths from the top directory, -of the IOCCC winner directories for a given year. For example, see the [1984/.year](/.1984/.year) file. +of the IOCCC entry directories for a given year. For example, see the [1984/.year](/.1984/.year) file. -Under each IOCCC winner directory, you will find a `.path` file. +Under each IOCCC entry directory, you will find a `.path` file. These files contain the directory path from the top directory. For example see [1984/anonymous/.path](/1984/anonymous/.path). diff --git a/thanks-for-help.html b/thanks-for-help.html index d5f55b5cb..31d82e8d0 100644 --- a/thanks-for-help.html +++ b/thanks-for-help.html @@ -110,31 +110,31 @@ thank you notes, we centralize them below..pathfile. These files contain the directory path from the top directory. For example see 1984/anonymous/.path.The IOCCC judges wish to recognize the many important contributions to the IOCCC presentation of past IOCCC entries. We are pleased to note the many contributions, -made since 2021 Jan 01, on a winner by winner +made since 2021 Jan 01, on a IOCCC entry by entry basis.
IOCCC thank you table of contents
-
- 1984 winners | 1985 winners -| 1986 winners | 1987 -winners
-- 1988 winners | 1989 winners -| 1990 winners | 1991 -winners
-- 1992 winners | 1993 winners -| 1994 winners | 1995 -winners
-- 1996 winners | 1998 winners -| 2000 winners | 2001 -winners
-- 2004 winners | 2005 winners -| 2006 winners | 2011 -winners
-- 2012 winners | 2013 winners -| 2014 winners | 2015 -winners
-- 2018 winners | 2019 winners -| 2020 winners
+- 1984 entries | 1985 entries +| 1986 entries | 1987 +entries
+- 1988 entries | 1989 entries +| 1990 entries | 1991 +entries
+- 1992 entries | 1993 entries +| 1994 entries | 1995 +entries
+- 1996 entries | 1998 entries +| 2000 entries | 2001 +entries
+- 2004 entries | 2005 entries +| 2006 entries | 2011 +entries
+- 2012 entries | 2013 entries +| 2014 entries | 2015 +entries
+- 2018 entries | 2019 entries +| 2020 entries
- General thanks
- Makefiles fixes and improvements
@@ -1404,7 +1404,7 @@ href="/1992/adrian/README.md%5D">README.md) the file the code was compiled from (__FILE__), notadgrep.c, as the latter does not exist:adgrepis simply a link toadrianasadgrepis what -the program was submitted as but the winner is +the program was submitted as but the entry’s winning source file isadrian.c.Not fixing the above problem would have also caused the program to crash if no arg was specified as the file doesn’t exist. In making the @@ -4420,9 +4420,9 @@ href="/2019/diels-grabsch1/try.sh">try.sh script.
href="/2019/diels-grabsch1/Shakespeare.txt">Shakespeare.txt from 2019/mills (after runningmake) so that one can not worry about having the entire -winner tree (or at least the 2019 tree each winner in a subdirectory). -This is more important as there is discussion of having tarballs for -each individual entry as a convenience. +IOCCC winning entry tree (or at least the 2019 tree each entry in a +subdirectory). This is more important as there is discussion of having +tarballs for each individual entry as a convenience.2019/diels-grabsch2 (README.md)
@@ -4808,10 +4808,10 @@ changes, fixes and important improvements and one who has literally (or numerically :-) ) contributed thousands, that we wish to thank.Authors
A good number of the past winners of the IOCCC -tested, identified and helped correct and/or improve the write-ups of -fellow IOCCC entries for the year that they won. The list of those past -winners is too long to mention: nevertheless the wining entries of the +IOCCC tested, identified and helped correct and/or improve the +write-ups of fellow IOCCC entries for the year that they won. The list +of those entries is too long to mention: nevertheless the IOCCC judges VERY MUCH APPRECIATE those who helped improve the presentation of their fellow IOCCC entries.
@@ -4872,10 +4872,10 @@ neglect to credit you?If you submitted a fix to an entry for which you are not the author, and your fix is accepted (in part or as a whole), we would be happy to add you to this honor roll list.
-If you believe we incorporated one of your fixes to an IOCCC winner -(that you are not the author of) for which we neglected to mention in -this file, please contact the IOCCC so that -we may correct the record.
+If you believe we incorporated one of your fixes to an IOCCC winning +entry (that you are not the author of) for which we neglected to mention +in this file, please contact the IOCCC so +that we may correct the record.
diff --git a/thanks-for-help.md b/thanks-for-help.md index f60c65892..0669b552a 100644 --- a/thanks-for-help.md +++ b/thanks-for-help.md @@ -9,18 +9,18 @@ we centralize them below. The [IOCCC judges](https://www.ioccc.org/judges.html) wish to recognize the many important contributions to the IOCCC presentation of past IOCCC entries. We are pleased to note the many contributions, **made since 2021 Jan 01**, -on a winner by winner basis. +on a IOCCC entry by entry basis. ## IOCCC thank you table of contents -- [1984 winners](#1984) | [1985 winners](#1985) | [1986 winners](#1986) | [1987 winners](#1987) -- [1988 winners](#1988) | [1989 winners](#1989) | [1990 winners](#1990) | [1991 winners](#1991) -- [1992 winners](#1992) | [1993 winners](#1993) | [1994 winners](#1994) | [1995 winners](#1995) -- [1996 winners](#1996) | [1998 winners](#1998) | [2000 winners](#2000) | [2001 winners](#2001) -- [2004 winners](#2004) | [2005 winners](#2005) | [2006 winners](#2006) | [2011 winners](#2011) -- [2012 winners](#2012) | [2013 winners](#2013) | [2014 winners](#2014) | [2015 winners](#2015) -- [2018 winners](#2018) | [2019 winners](#2019) | [2020 winners](#2020) +- [1984 entries](#1984) | [1985 entries](#1985) | [1986 entries](#1986) | [1987 entries](#1987) +- [1988 entries](#1988) | [1989 entries](#1989) | [1990 entries](#1990) | [1991 entries](#1991) +- [1992 entries](#1992) | [1993 entries](#1993) | [1994 entries](#1994) | [1995 entries](#1995) +- [1996 entries](#1996) | [1998 entries](#1998) | [2000 entries](#2000) | [2001 entries](#2001) +- [2004 entries](#2004) | [2005 entries](#2005) | [2006 entries](#2006) | [2011 entries](#2011) +- [2012 entries](#2012) | [2013 entries](#2013) | [2014 entries](#2014) | [2015 entries](#2015) +- [2018 entries](#2018) | [2019 entries](#2019) | [2020 entries](#2020) - [General thanks](#general_thanks) - [Makefiles fixes and improvements](#makefiles_fixes_improvements) - [Consistency improvements](#consistency_improvements) @@ -1425,7 +1425,7 @@ should have been removed. [Cody](#cody) fixed the code so that it will try opening the file the code was compiled from (`__FILE__`), not `adgrep.c`, as the latter does not exist: `adgrep` is simply a link to `adrian` as `adgrep` is what the program was submitted as but -the winner is `adrian.c`. +the entry's winning source file is `adrian.c`. Not fixing the above problem would have also caused the program to crash if no arg was specified as the file doesn't exist. In making the above fix, at first @@ -4586,8 +4586,8 @@ bugs.md](/bugs.md#2019-ciura) for more details. Cody also added the file [Shakespeare.txt](/2019/diels-grabsch1/Shakespeare.txt) from [2019/mills](/2019/mills/README.md) (after running `make`) so that one can -not worry about having the entire winner tree (or at least the 2019 tree each -winner in a subdirectory). This is more important as there is discussion of +not worry about having the entire IOCCC winning entry tree (or at least the 2019 tree each +entry in a subdirectory). This is more important as there is discussion of having tarballs for each individual entry as a convenience. @@ -4998,10 +4998,10 @@ contributed thousands, that we wish to thank. ### Authors -A good number of the [past winners of the +A good number of the [wining entries of the IOCCC](https://www.ioccc.org/authors.html) tested, identified and helped correct and/or improve the write-ups of fellow IOCCC entries for the year that they won. -The list of those past winners is too long to mention: nevertheless the [IOCCC +The list of those entries is too long to mention: nevertheless the [IOCCC judges](https://www.ioccc.org/judges.html) **VERY MUCH APPRECIATE** those who helped improve the presentation of their fellow IOCCC entries. @@ -5065,6 +5065,6 @@ If you submitted a fix to an entry for which you are not the author, and your fix is accepted (in part or as a whole), we would be happy to add you to this [honor roll list](#thank_you_honor_roll). -If you believe we incorporated one of your fixes to an IOCCC winner (that you +If you believe we incorporated one of your fixes to an IOCCC winning entry (that you are not the author of) for which we neglected to mention in this file, please [contact the IOCCC](contact.html) so that we may correct the record.