mirror/ioccc
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

move fix thanks a file, update top level html links, rename CONTRIBUTING.md

Browse Source 
The fix thank you's have been moved from `README.md` to
`thanks-for-fixes.md`.

**WARNING**: Some mistakes may have been made in doing this.
We presume later changes by others will correct any issues.

The `CONTRIBUTING.md` was renamed `how-to-enter.md`.

A 3rd line of links was added to top level html such as
`contact.html`, `index.html`, `judges.html`, `winners.html`,
and `years.html`.

Improved blank line use in a number (but not all) `README.md` files.
This commit is contained in:
Landon Curt Noll committed 2023-06-06 16:59:53 -07:00
1 parent 23f7ac0a49
commit ac41f07a83
92 files changed
+1326 -761
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

2006/birken/README.md
+9 -5
View File
@@ -1,26 +1,23 @@
# EDAMAME Award
## (Electronic Design Automation - Mechanical Abstract Machine Emulator)
Michael Birken
US
<o__1 at hotmail dot com>
## To build:
```sh
make
```
## To run:
```sh
./birken < file.tofu
```
[Cody Boone Ferguson](/winners.html#Cody_Boone_Ferguson) fixed a segfault in
macOS with this entry. The problem was a missing `+1` for strlen() with
malloc(). This prevented it from working. Thank you Cody for your assistance!
## Try:
@@ -33,8 +30,13 @@ malloc(). This prevented it from working. Thank you Cody for your assistance!
etc.
## Judges' remarks:
Q: EDAMAME?
A: Electronic Design Automation - Mechanical Abstract Machine Emulator
What is TUFO? It's not a veggy friendly food, nor it is Verilog or
VHDL. It is not even Pascal!
@@ -52,6 +54,7 @@ And for those who are still confused:
> <http://en.wikipedia.org/wiki/Edamame>
> <http://en.wikipedia.org/wiki/Tofu>
## Author's remarks:
If man is capable of creating [tofu](http://en.wikipedia.org/wiki/Tofu) [hot
@@ -72,6 +75,7 @@ out the one who discovers the hidden program within the source.
Note that the shape of the source is a wave, not a waveform.
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
2006/borsanyi/README.md
+5 -3
View File
@@ -4,15 +4,13 @@ Szabolcs Borsanyi
United Kingdom
s.borsanyi at sussex dot ac dot uk
## To build:
```sh
make
```
[Cody Boone Ferguson](/winners.html#Cody_Boone_Ferguson) fixed (the Makefile)
under some systems where the `lpthread` was not implicitly linked in. Thank you
Cody!
## To run:
@@ -20,12 +18,14 @@ Cody!
./borsanyi string > file.gif
```
## Try:
```sh
./borsanyi ioccc@example.com > example.gif
```
## Judges' remarks:
This entry uses a very user-friendly representation of the font
@@ -37,6 +37,7 @@ recognition tools. The amount of imagination necessary to
recognise the @ character will certainly challenge a few
anti-CAPTCHA tools.
## Author's remarks:
### Email address to gif converter
@@ -98,6 +99,7 @@ output is used for a binary output, which might cause problems.
To avoid most caveats, the program does not output the octet
`0x0a`. The program assumes the use of ASCII.
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
2006/monge/README.md
+5 -8
View File
@@ -4,6 +4,7 @@ Maurizio Monge
Italy
<maurizio.monge at gmail dot com>
## To build:
Make sure you have the SDL1 (not SDL2!) development environment installed.
@@ -12,14 +13,6 @@ Make sure you have the SDL1 (not SDL2!) development environment installed.
make
```
[Cody Boone Ferguson](/winners.html#Cody_Boone_Ferguson) pointed out that
without SDL1 (**not** SDL2) this will not link because two functions that are
used were removed from SDL2. Since SDL1 is still available and since changing
the code to use SDL2 would be more complicated he decided to change the Makefile
to use `sdl-config` not `sdl2-config`. Nevertheless he points out that the entry
requires x86/x86_64 CPUs. Without it it might very well segfault (for instance
it segfaulted on his MacBook Pro with the M1 chip).
## To run:
@@ -27,6 +20,7 @@ it segfaulted on his MacBook Pro with the M1 chip).
./monge expression ...
```
## Try:
```sh
@@ -37,6 +31,7 @@ it segfaulted on his MacBook Pro with the M1 chip).
Incorrect formulas will ungracefully crash the program.
## Judges' remarks:
For those who are familiar with the previous [IOCCC winners](/winners.html),
@@ -52,6 +47,7 @@ At the time of judging we were too mesmerized by the graphics
to realize it; and, after all, this entry does take a special
effort to work on both `i386` and `x86_64`. Portable it is! :)
## Author's remarks:
### For the impatient:
@@ -209,6 +205,7 @@ floating point offset to where the value was actually calculated.
When zooming, the best match is searched, and if the offset is
too big (`>1`) the pixel is recalculated.
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
2006/night/README.md
+7 -5
View File
@@ -4,12 +4,14 @@ Christopher Night
US
<https://web.archive.org/web/20090415070532/https://www.people.fas.harvard.edu/~night>
## To build:
```sh
make
```
## To run:
```sh
@@ -19,17 +21,17 @@ make
There is an alternate version that supports arrow keys. See the alternate code
section below.
## Try:
```sh
echo "Do or do not. There is no try."
```
### Alternate code:
As [Cody Boone Ferguson](/winners.html#Cody_Boone_Ferguson) is a lost :-) `vim`
user he took the author's remarks to add support back for arrow keys. To use
compile like:
To compile:
```sh
@@ -38,8 +40,6 @@ make alt
Use `night.alt` as you would `night` above.
Thank you Cody!
## Judges' remarks:
@@ -55,6 +55,7 @@ There is a nice way to cheat. If you don't want to figure it out you can look at
(translation from Japanese so it's not perfect)
<https://mame-github-io.translate.goog/ioccc-ja-spoilers/2006/night.html?_x_tr_sl=auto&_x_tr_tl=en&_x_tr_hl=en-US&_x_tr_pto=wapp>.
## Author's remarks:
Don't worry; this is not a self-reproducing program, as you might at
@@ -146,6 +147,7 @@ following two macros to:
Code on!
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
2006/sloane/README.md
+5 -13
View File
@@ -3,22 +3,13 @@
Andy Sloane
US
## To build:
```sh
make
```
[Cody Boone Ferguson](/winners.html#Cody_Boone_Ferguson) fixed this entry to
work with clang which is stricter on the type of args to main(). Curiously
although clang requires the types of args to be strictly correct it allows for
only one arg which he made it as the second arg was not used and this allows for
a closer match to the original format of the entry. He also made sure that the
Makefile links in `libm` as not all systems do this by default. Since the author
suggested that the lack of certain `#include`s might break the program in some
systems he added `-include ...` to the Makefile as well. Thank you Cody for your
assistance!
## To run:
@@ -40,10 +31,10 @@ movements. See the alternate code section below.
echo "Do or do not. There is no try."
```
### Alternate code:
The alternate version, provided by [Cody Boone
Ferguson](/winners.html#Cody_Boone_Ferguson), uses `usleep()` so one can enjoy
The alternate version uses `usleep()` so one can enjoy
the entry with modern systems and which will not be too stimulating for those
who have a problem with fast moving text (like himself). It uses the `Z` macro
as the parameter to `usleep()` which you can override. The default is
@@ -62,13 +53,13 @@ make CDEFINE="-DZ=70000" clobber alt
Use `sloane.alt` as you would `sloane` above.
Thank you Cody!
## Judges' Comments:
Looks almost good enough to eat, dunnit? I suppose you could argue that,
at first blush, this looks like a self-reproducing program.
## Author's remarks:
This program doesn't require any special build options, other than that it
@@ -123,6 +114,7 @@ In increasing order of difficulty:
- How is the "IOCCC 2006" logo encoded? Can you put something else in its
place? Can you find a smaller encoding?
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
2006/toledo2/README.md
+7 -7
View File
@@ -5,26 +5,22 @@ Familia Toledo
Mexico
<https://nanochess.org>
## To build:
```sh
make
```
## To run:
```sh
./toledo2
```
[Cody Boone Ferguson](/winners.html#Cody_Boone_Ferguson) fixed a segfault in
this program which was making it fail to work under macOS - it did not seem to
be a problem under linux, at least not fedora. The problem was wrong variable
types - implicit `int`s instead of `FILE *`s. It now works with both macOS and
linux. Thank you Cody!
To end execution press `ctrl-z`. As mentioned in the author's remarks and in the
below section, it is supposed to crash on termination though Cody noted this
below section, it is supposed to crash on termination though some noted this
does not seem to happen in macOS. He asks ironically: 'if it's supposed to crash
and it does not crash is it actually a bug or is it a feature? :-)'
@@ -35,6 +31,7 @@ By design this program is supposed to crash on termination.
You must type in caps (except in strings) and this program is indeed
case-sensitive.
## Try:
```sh
@@ -60,6 +57,7 @@ remarks.
See also [bugs.md](/bugs.md) for more details.
## Judges' remarks:
We're impressed! Last year, it was a
@@ -80,6 +78,7 @@ file referred in the author's remarks); walking in a maze of
twisty little passages all alike is easier than understanding
the code!
## Author's remarks:
This program emulates a complete [Intel(r)
@@ -260,6 +259,7 @@ The BIOS is tailor made for this emulator, and helps to simplify it.
programmer can develop its C programs using
only one function.
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
2006/toledo3/README.md
+5 -6
View File
@@ -5,24 +5,20 @@ Familia Toledo
Mexico
<https://nanochess.org>
## To build:
```sh
make
```
## To run:
```sh
./toledo3 [1 | 2 | 3 [b]]
```
[Cody Boone Ferguson](/winners.html#Cody_Boone_Ferguson) fixed a crash and a
display problem in this entry so that it now works in modern (64-bit) systems.
The problem was that it relied on 32-bits so some `int`s were changed to
`long`s. At this time we don't have an easy way to test this theory but it might
be that using `-m32` would let this work in 32-bit systems. Thank you Cody for
your assistance!
## Try:
@@ -30,6 +26,7 @@ your assistance!
./toledo3 1
```
### Alternate versions:
The author provided two additional versions, [toledo3-sbar.c](toledo3-sbar.c)
@@ -46,6 +43,7 @@ since it's clearly spelled out in the code. The interesting
question is whether this is easier or harder to understand than
the code for Deep Blue.
## Author's remarks:
There are so many text-based chess programs, what is that of
@@ -131,6 +129,7 @@ rules) creates a status display about gameplay on the window title bar.
Using [toledo3-txt.c](toledo3-txt.c) turns this into being purely text based.
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.