From a59162673cd072fecf423596e3e2e9e34cc90d58 Mon Sep 17 00:00:00 2001 From: Cody Boone Ferguson <53008573+xexyl@users.noreply.github.com> Date: Thu, 30 Mar 2023 06:39:35 -0700 Subject: [PATCH] Add faq.md, remove faq.html I tried to keep the formatting as close to the original as possible. It's very likely links have to be fixed and it's very likely formatting has to be fixed. Some things necessarily had to change but very few did in fact need to change. As tempting as it was to change it to British English I did not (though I started to when fixing a link but I caught myself in time) :-) Naturally as this is a major change problems are expected but these will be worked out. I guess the next step would be to do this for other raw html files but I don't fancy doing more than one in a day. This can be discussed later though as some will be automatically generated anyway so no need for a markdown file (faq.md was discussed as a good idea). --- faq.html | 774 ++++++++++++++++++++++++------------------------------- faq.md | 433 +++++++++++++++++++++++++++++++ 2 files changed, 771 insertions(+), 436 deletions(-) create mode 100644 faq.md diff --git a/faq.html b/faq.html index 15f38e06b..0682ee9d5 100644 --- a/faq.html +++ b/faq.html @@ -1,546 +1,448 @@ - - -
- - - - -+
-
[ The judges | +

[ The judges |
IOCCC home page |
How to enter |
FAQ |
Contacting the IOCCC
-
+
IOCCC news |
People who have won |
-Winning entries ]
-
Q: How many entries do you receive each -year? -- -
A: By tradition, we do not say. -Q: How many judging rounds do you have? -
A: Are you trying to trick us? We will not say -that either. -Q: I cannot get entry xyzzy from year 19xx to compile! -
A: 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. -
E.g. it is highly unlikely that you'll be able to execute 1984/mullender on a computer you're using to read this FAQ. -Q: I found a bug in a previous winner, what should -I do? -
A: We do not ``maintain'' the contest winners. -The code is made available on an ``AS IS'' basis. If you have a FIX for +The IOCCC FAQ
+ +Q: How many entries do you receive each year?
+ +By tradition, we do not say.
+ +Q: How many judging rounds do you have?
+ +Are you trying to trick us? We will not say that either.
+ +Q: I cannot get entry XYZZY from year 19xx to 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.
+ +E.g. it is highly unlikely that you'll be able to execute +1984/mullender on a computer you're using to read +this FAQ.
+ +Q: I found a bug in a previous winner, what should I do?
+ +We do not 'maintain' the contest winners. The code is made available on an 'AS +IS' basis. If you have a FIX for a entry, we suggest that you try and email it to the authors and to CC: -us using the instructions on the contacting the IOCCC -Judges page. -
+ +
IF you have a FIX, and IF the author does not object, and IF your fix +us using the instructions on the +contacting the IOCCC Judges page.IF you have a FIX, and IF the author does not object, and IF your fix looks reasonable, we will add a web link to a copy of your email -for others to see. -
Q: Are there types of entries that are submitted -so frequently that the judges get tired of them? -
A: Yes, there are types of entries that show up -over and over again. -
The guidelines say: -We tend to dislike programs that: --We like variety. However too often we see (please look at the winning examples -given to be aware of the level of the competition): -are similar to previous winners --
-- -maze generator +for others to see. -
-
-- -1985/shapiro
+Q: Are there types of entries that are submitted so frequently that the judges get tired of them?
-- -1991/buzzard
+Yes, there are types of entries that show up over and over again.
-- -1995/cdua
+The guidelines say:
-- -1995/dodsond2
+-We tend to dislike programs that: are similar to previous winners
- -1998/bas1
-- -tic-tac-toe game +
We like variety. However too often we see (please look at the winning examples +given to be aware of the level of the competition):
--
-- -1991/westley
+maze generator
-- -1996/jonth
+ -- -2020/carlini
-- -solitaire/Othello game +
tic-tac-toe game
--
-- -1987/lievaart
+ -- -1994/dodsond1
-- -generating small primes (below is the list of all -prime related winners) +
solitaire/Othello game
--
-As you can see, just a list of primes (let alone small primes) does -not cut it anymore. +- -1985/august
+ -- -1988/applin
-- -1994/weisberg
+generating small primes (below is the list of all prime related winners)
-- -1995/makarios
+ -- -1996/dalbec
-- -2000/bellard
-As you can see, just a list of primes (let alone small primes) does not cut it +anymore.
-- -self reproducing program +
self reproducing program
--
+- -1990/scjones
++
-- +
- +
1994/smr - _do not claim your program is the smallest one without seeing it!
- +
2000/dhyang - unless you beat this one, your chances are slim
- -1994/smr - do not claim your program -is the smallest one without seeing it
-- -2000/dhyang - unless you beat this -one, your chances are slim
-entries that just print "Hello, world!"
-- -entries that just print "Hello, world!" + -
-
-It's so 20th century... + -- -1984/anonymous
-- -1985/applin
+it's so 20th century...
-- -1986/applin
+entries that use some complex state machine/table to print something
-- -1986/holloway
+ -- -1989/jar.1
-- -1992/lush
+rot13
-- -2000/tomx
-- -entries that use some complex state machine/table to print -something -
-
+ -- -1988/isaak
+pi or e computation
-- -1988/phillipps
-- -rot13
--
- -- -1985/sicherman
-- -1989/westley
- -- -1990/dg
- -- -1991/fine
-- -pi or e computation - -
-
-- -1986/august
- -- -1988/robison
- -- -1988/westley
- -- -1989/roemer
-HINT: It is not fatal to send in those types of entries, it is just MUCH +
HINT: It is not fatal to send in those types of entries, it is just MUCH HARDER to win. Such an entry would have to do something really unique and interesting to even make it into the final judging rounds. Entries that re-use these 'worn out' themes frequently lose to other entries that do -something different. -
HINT: If you really MUST send in an entry based on an 'over-used theme', +something different.
+ +HINT: If you really MUST send in an entry based on an 'over-used theme', be sure that it is obfuscated in several new and novel ways. Be sure to clearly explain near the beginning of your remarks why you are submitting a entry based on an 'over-used theme' and why the judges should not simply toss -it out as being boring. -
Q: What should I write in the 'remark' section -of my entry, if anything at all? -
A: As much or as little as you wish. -What helps: -
-
-- -explaining what your entry does
+it out as being boring. -- -how to entice it to do what it is supposed to do
+Q: What should I write in the 'remarks' (remarks.md) section of my entry, if anything at all?
-- -what obfuscations are used
+As much or as little as you wish.
-- -what are the limitations of your entry in respect of portability and/or input -data
+What helps:
-- -how it works (if you are really condescending)
-What does not help: -
-
-- -admitting that your entry is not very obfuscated (you see, the contest -is called IOCCC, not INVOCCC); but even if you do not admit it, -not very obfuscated entries have a minuscule chance to win -(although 2000/tomx is a notable counterexample)
++
-- +
explaining what your entry does
- +
how to entice it to do what it is supposed to do
- +
what obfuscations are used
- +
what are the limitations of your entry in respect of portability and/or input data
- +
how it works (if you are really condescending)
- -mentioning your name or any identifying information in the remark section -(or in the C code for that matter) - we like to be unbiased during the -judging rounds; we look at the author name only if an entry wins
-- -leaving the remark section empty
-Q: I am confused: what should I put to the 'build' -section? -
A: The 'build' section must contain UNIX shell-style -commands to compile your C language entry in a file named prog.c -and produce an executable file. More than one command is allowed, +What does not help:
+ ++
+ + +- +
admitting that your entry is not very obfuscated (you see, the contest is +called IOCCC, not INVOCCC); but even if you do not admit it, not +very obfuscated entries have a minuscule chance to win (although +2000/tomx is a notable counterexample)
- +
mentioning your name or any identifying information in the remark section (or +in the C code for that matter) - we like to be unbiased during the judging +rounds; we look at the author name only if an entry wins
- +
leaving the remark section empty
Q: I am confused: what should I put to the 'build' section?
+ +The 'build' section must contain UNIX shell-style commands to compile your C +language entry in a file named prog.c and produce an executable file. More than one command is allowed, as far as the size rule is followed. Usually one (or more) of these commands will be an invocation of -a C compiler (use cc or gcc), but there may be exceptions -(or not anymore, see 2000/tomx). -
If your entry depends on a particular source file name during -compilation or execution, you will have to put a line -cp prog.c desired_name.cbefore the compiler invocation line. -
If in doubt, put -cc -o prog prog.cin the 'build' section. -Q: What happened to the winners for 1997, 1999 -and 2002? -
A: There are none. There was no IOCCC in those -years. -Q: Why don't you publish non-winners? -
+ +
A: Because the publication on the IOCCC site IS +a C compiler (use cc or gcc), but there may be exceptions +(or not anymore, see 2000/tomx).If your entry depends on a particular source file name during compilation or execution, you will have to put a line
+ ++ +cp prog.c desired_name.c +before the compiler invocation line.
+ +If in doubt, put
+ ++ +cc -o prog prog.c +in the 'build' section.
+ +Note however that with the mkiocccentry +tool we have an example Makefile +which you should update, using the instructions above if necessary.
+ +Q: What happened to the winners for 1997, 1999 2002, 2003, 2007 - 2010, 2016, 2017, 2021 and 2022 ?
+ +There are none. There was no IOCCC in those years.
+ +Q: Why don't you publish non-winners?
+ +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. -
Q: How much time does it take to judge the contest? -
A: It takes a fair amount of time to setup, run, -answer email, process (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 sure that your entry does work on at least a couple different platforms, -at least one of them being UNIX or POSIX-conforming) 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. -Q: What platform should I assume for my entry? -
A: Your entry must compile with GCC and run under -at least one flavor of UNIX (e.g. Linux or Solaris). To improve chances -to win, it should work under both BSD and SysV style UNIX (think stty -cbreak), and should not depend on endianness. If it can compile and -run on Windows and/or Mac (see 2000/thadgavin), -even better. -Q: I would like to mirror the IOCCC web site. May -I do so? -
-
A:We are not accepting mirror requests at this time, sorry. -Q: I want to publish some parts of the IOCCC in -an article, or book, or newsletter, or use then in class/instructional -notes, or quote from the IOCCC. May I do so? -
A: Please ask the IOCCC judges first. Please send -your request using the instructions on the contacting -the IOCCC Judges page. -Q: What are the grand prize / Best of Show winners? -
A: In 1984-1987, the grand prize winners are: --
- -1984/mullender
+non-winners on their web page for everyone to see.-1985/shapiro +Q: How much time does it take to judge the contest?
--1986/wall +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.
--1987/lievaart - -
Starting from 1988, the entry we liked the most in that year is called -"Best of Show". Here are the "Best of Show" entries: --
-- -1988/applin
+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 sure that your entry does work +on at least a couple different platforms, at least one of them being UNIX or +POSIX-conforming.
-- -1989/jar.2
+Q: What platform should I assume for my entry?
-- -1990/theorem
+Your entry must compile with GCC and run under at least one flavor of UNIX (e.g. +Linux or Solaris). To improve chances to win, it should work under both BSD and +SysV style UNIX (think stty cbreak), and should not depend on endianness. +If it can compile and run on Windows and/or Mac (see +2000/thadgavin for one example, amongst others), even better.
-- -1991/brnstnd
+Q: I would like to mirror the IOCCC web site. May I do so?
-- -1992/vern
+We are not accepting mirror requests at this time, sorry.
-- -1996/august
+Q: I want to publish some parts of the IOCCC in an article, or book, or newsletter, or use then in class/instructional notes, or quote from the IOCCC. May I do so?
-- -1998/banks
+Please ask the IOCCC judges first. Please send your request using the +instructions on the contacting the IOCCC Judges page.
-- -2000/jarijyrki
-
In 1993, 1994 and 1995 the judges were unable to select a clear overall +Q: What are the grand prize / Best of Show winners?
+ +In 1984-1987, the grand prize winners are:
+ + + + +Starting from 1988, the entry we liked the most in that year is called +"Best of Show". Here are the "Best of Show" entries:
+ ++
+ + +- +
- +
- +
- +
- +
- +
- +
- +
- +
In 1993, 1994 and 1995 the judges were unable to select a clear overall winner. So to give a nod to the entry that had the highest approval ranking -from the judges, they used the following awards: -
-
-These could be considered the 'better entry' for those years with 1 or -more other entries that came in close behind. -- -1993/rince - Most Well Rounded
+from the judges, they used the following awards: -- -1994/shapiro - Most Well Rounded
++
-- +
1993/rince - Most Well Rounded
- +
1994/shapiro - Most Well Rounded
- +
1995/leo - Best Use of Obfuscation
- -1995/leo - Best Use of Obfuscation
-Q: I managed to get entry xyzzy from year 19xx to compile; now it fails to run! -
A: switch(19xx/xyzzy) {-
-- case 1984/mullender: try -
-main(){int i=512;do write(1," :-)\b\b\b\b",9),usleep(i);while(--i);}-instead.
Enable reverse wraparound in your xterm window for best results. -
break; -- case 1991/davidguy: disable access -control of your X server (xhost +). If it does not help (or if you +
+These could be considered the 'best entry' for those years with 1 or +more other entries that came in close behind.
+ +Q: I managed to get entry XYZZY from year 19xx to compile; now it fails to run!
+ +switch(19xx/XYZZY) {
+ ++
+ + +- +
case 1984/mullender: try
+ +main(){int i=512;do write(1," :-)\b\b\b\b",9),usleep(i);while(--i);}
instead. Enable reverse wraparound in your xterm window for best results.
+ +break;
+ ++
-} +depth of 8 bits or less.- case 1991/davidguy: disable access +control of your X server (xhost +). If it does not help (or if you see black screen), restart the X server without access control and with visual -depth of 8 bits or less. -
-
break; -- default: Try enabling -fwritable-strings for GCC -or its equivalent for other compilers. -
Q: How -did the IOCCC get started? -
A: -One day (23 March 1984 to be exact), back Larry Bassel and I (Landon Curt +break;
+ ++
+ + +- default: Try enabling -fwritable-strings for GCC +or its equivalent for other compilers.
+}
+ +Q: How did the IOCCC get started?
+ +One day (23 March 1984 to be exact), Larry Bassel and I (Landon Curt Noll) were working for National Semiconductor's Genix porting group, we -were both in our offices trying to fix some very broken code. -Larry had -been trying to fix a bug in the classic Bourne shell (C code #defined -to death to sort of look like Algol) and I had been working on the -finger program from early BSD (a bug ridden finger implementation to be -sure). -We happened to both wander (at the same time) out to the hallway -in Building 7C to clear our heads. +were both in our offices trying to fix some very broken code.
-+
Larry had been trying to fix a bug in the classic Bourne shell (C code #defined +to death to sort of look like Algol) and I had been working on the finger +program from early BSD (a bug ridden finger implementation to be sure).
-We began to compare notes: ''You won't believe the code I am trying to -fix''. -And: ''Well you cannot imagine the brain damage level of the code -I'm trying to fix''. -As well as: ''It's more than bad code, the author really -had to try to make it this bad!''. +We happened to both wander (at the same time) out to the hallway +in Building 7C to clear our heads.
-+
We began to compare notes: 'You won't believe the code I am trying to fix'.
-After a few minutes we wandered back into my office where I posted a -flame -to net.lang.c -inviting people to try and out obfuscate the -UN*X source code we had just been working on. +And: 'Well you cannot imagine the brain damage level of the code I'm trying to +fix'.
-+- -As well as: 'It's more than bad code, the author really had to try to make it +this bad!
-BTW: -I (Landon Curt Noll) -had to post this -typo -correction. -Thus began the tradition of putting typos in the contest rules and -guidelines ... to make them more obfuscated of course! :-) +After a few minutes we wandered back into my office where I posted a +flame to to +net.lang.c +inviting people to try and out obfuscate the UN*X source code we had just been working on.
-+
BTW: I (Landon Curt Noll) had to post this typo +correction. +Thus began the tradition of putting typos in the contest rules and guidelines +... to make them more obfuscated of course! :-)
-BTW: -This posting was made back in the days when AT&T was the evil giant. -Now, Microsoft makes AT&T look mild and kind in comparison. :-( (IMHO) ). +BTW: This posting was made back in the days when AT&T was the evil giant. +Now, Microsoft makes AT&T look mild and kind in comparison. :-( (IMHO) ).
-+
BTW: See the story about the 'Bill Gates' award. :-)
-BTW: -See the story about the '' -Bill Gates'' award. :-) +OK, back to the story.
-- -OK, back to the story. -We (Larry and I) received a number of entries by email. +
We (Larry and I) received a number of entries by email. When we began to receive messages from outside of the US, Larry and I -decided to include International in the name. -The -1st IOCCC winners -were posted on 17 April 1984. +decided to include International in the name.
-++The +1st IOCCC winners +were posted on 17 April 1984.
-There were 4 winners in 1984: +There were 4 winners in 1984:
- + -BTW: -The <dis>honorable -mention wished to remain anonymous. + +BTW: The (dis)honorable mention wished to remain anonymous. While many have asked who it was, we have continued to follow the -author's wish to remain anonymous. -A few years ago, we asked the author if they still wanted to remain anonymous. -They said: ''Yes, I want to keep my anonymity. -But you can tell them that I am a well known for my connection to the -C language"''. -It was not until 2001 that another -anonymous -entry received an award. +author's wish to remain anonymous.
-+
A few years ago, we asked the author if they still wanted to remain anonymous. +They said: 'Yes, I want to keep my anonymity. But you can tell them that I am a well known for my connection to the +C language"'. It was not until 2001 that another anonymous +entry received an award.
-BTW: -The -1984 winner -remains one of my (Landon Curt Noll) all time favorites. +BTW: The 1984 winner remains one of my (Landon +Curt Noll) all time favorites.
-The name used in the posting of the 1st IOCCC +winner +posting was International Obfuscated C Code Contest or +IOCCC for short.
-The name used in the posting of the -1st -IOCCC winner -posting was International Obfuscated C Code -Contest or IOCCC for short. +The posting said '1st annual', so in 1985 we held the 2nd IOCCC contest +and the tradition continues as the longest running contest on the Internet.
--The posting said ''1st annual'', -so in 1985 we held the -2nd IOCCC contest -and the tradition continues as the longest running contest -on the Internet. +
P.S. Part of the inspiration for making the IOCCC a contest goes to the +Bulwer-Lytton fiction contest.
-+
-P.S. Part of the inspiration for making the IOCCC a contest goes to the -Bulwer-Lytton fiction contest. +P2.S. See the +overall README +for more details.
-- -P^2.S. See the -overall README -for more details. - -
![]() |
© Copyright 1984-2020,
-Leo Broukhis, Landon Curt Noll
-- All rights reserved |
- |

[ The judges |
+IOCCC home page |
+How to enter |
+FAQ |
+Contacting the IOCCC
+
+IOCCC news |
+People who have won |
+Winning entries ]
+ +P^2.S. See the +[overall README](/all/README) +for more details. + +
![]() |
+© Copyright 1984-2020,
+[Leo Broukhis, Landon Curt Noll](/judges.html)
+- All rights reserved |
++ |