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

fix standard headers and header spacing in winner README.md files

Browse Source
This commit is contained in:
Landon Curt Noll committed 2023-11-02 15:45:36 -07:00
1 parent 50837e452e
commit fbd20cfdc2
319 files changed
+1601 -382
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

2020/burton/README.md
+6 -2
View File
@@ -3,6 +3,7 @@
Dave Burton
<http://snox.net/ioccc>
## To build:
```sh
@@ -10,7 +11,7 @@ make
```
### Bugs and (Mis)features
### Bugs and (Mis)features:
The current status of this entry is:
@@ -28,7 +29,7 @@ For more detailed information see [2020 burton in bugs.md](/bugs.md#2020-burton)
```
## Try:
### Try:
```sh
./prog 128
@@ -52,6 +53,7 @@ An alternate version is also compiled for Big Endian machines.
Use `prog_be` as you would `prog` above.
## Judges' remarks:
Can you determine why this shows strange output for `./prog 128 128`
@@ -77,6 +79,7 @@ This code may be tested by:
make test
```
## Author's remarks:
Invoke this with a single non-negative integer less than 256, and a useful
@@ -125,6 +128,7 @@ You might be interested to compile it both ways on the same host, and try:
./prog 1; ./prog_be 1
```
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
2020/carlini/README.md
+7 -1
View File
@@ -3,25 +3,29 @@
Nicholas Carlini <nicholas@carlini.com>\
<https://nicholas.carlini.com>
## To build:
```sh
make
```
## To use:
```sh
./prog
```
## Try:
### Try:
```sh
# Play with a friend, P1 and P2, squares are numbered 1..9
./prog
```
## Judges' remarks:
This program consists of a single print statement wrapped in a while loop. You
@@ -29,6 +33,7 @@ would not think that this would amount to much, but you would be very, very
wrong. A clue to what is happening and how this works is encoded in the
ASCII art of the program source.
## Author's remarks:
HOW ABOUT A NICE GAME OF <strike>CHESS</strike>TIC-TAC-TOE?
@@ -317,6 +322,7 @@ block before the first `printf()`, but we initialize the `scanf()` format to the
string so that it returns right away without blocking. The first time the `printf()`
call runs, it writes out `"%hhd"` to create the `scanf()` format string.
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
2020/endoh1/README.md
+7 -1
View File
@@ -4,19 +4,22 @@ Yusuke Endoh
<https://github.com/mame/>\
Mastodon: [@mame@ruby.social](https://ruby.social/@mame)
## To build:
```sh
make
```
## To use:
```sh
./prog
```
## Try:
### Try:
```sh
@@ -43,6 +46,7 @@ make alt
Use `prog.alt` as you would `prog` above.
## Judges' remarks:
When playing Minesweeper, a misclick might ruin a game, so why not leave the
@@ -56,6 +60,7 @@ encounter any problems?
The submission was in violation of the "2053" size rule by one character, likely
a late typo. It was easy to fix.
## Author's remarks:
### Semi-automatic Minesweeper:
@@ -184,6 +189,7 @@ Ilya Kurdyukov also pointed out a warning "ignoring return value of 'fscanf'" on
Don Yang (omoikane) contributed another example map "megumin.txt" which is the Explosion Arch-Wizard.
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
2020/endoh2/README.md
+7 -1
View File
@@ -4,19 +4,22 @@ Yusuke Endoh\
<https://github.com/mame/>\
Mastodon: [@mame@ruby.social](https://ruby.social/@mame)
## To build:
```sh
make
```
## To use:
```sh
./prog
```
## Try:
### Try:
```sh
./prog
@@ -28,6 +31,7 @@ make
./prog bear.txt
```
## Judges' remarks:
Clever use of the C99 complex data type. The [spoiler](spoiler/) directory
@@ -37,6 +41,7 @@ shapes.
With the source from the [spoiler](spoiler/) directory could you make the code
render for a larger terminal window? How about adding more glyphs?
## Author's remarks:
No! Try not. Do, or do not. There is no try.
@@ -54,6 +59,7 @@ See spoiler.zip for the source code.
[1]: https://en.wikipedia.org/wiki/List_of_the_most_common_passwords
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
2020/endoh3/README.md
+7 -1
View File
@@ -4,19 +4,22 @@ Yusuke Endoh\
<https://github.com/mame/>\
Mastodon: [@mame@ruby.social](https://ruby.social/@mame)
## To build:
```sh
make
```
## To use:
```sh
./prog
```
## Try:
### Try:
```sh
./run_clock
@@ -35,6 +38,7 @@ make alt
Use `prog.alt` as you would `prog` above.
## Judges' remarks:
You may be tempted to use a mirror. Resist the temptation! Try figuring out how the clock hands are drawn.
@@ -42,6 +46,7 @@ Can you change the program to make it draw a familiar (non-mirrored) clock face?
When using the `run_clock` shell script, your perception of time might depend on what time it is.
## Author's remarks:
Prepare a mirror!
@@ -52,6 +57,7 @@ make clock
Note: You need to recompile it each run.
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
2020/ferguson1/README.md
+6 -3
View File
@@ -5,6 +5,7 @@ Cody Boone Ferguson <ioccc@xexyl.net>\
<https://xexyl.net>\
Mastodon: [@xexyl@fosstodon.org](https://fosstodon.org/@xexyl)
## To build:
```sh
@@ -12,7 +13,7 @@ make
```
### Bugs and (Mis)features
### Bugs and (Mis)features:
The current status of this entry is:
@@ -92,8 +93,7 @@ and non-zero).
(cannot - die if you try).
## Try:
### Try:
```sh
make test
@@ -117,6 +117,7 @@ CANNIBAL=1 WALLS=1 WAIT=0 EVADE=1 MAXSIZE=10 ./prog
# allows for configuring colours
```
## Judges' remarks:
As the [Gadsden flag](https://en.wikipedia.org/wiki/Gadsden_flag) warns, beware of the snake!
@@ -148,6 +149,7 @@ Because most of us could use some *Double-layered Chocolate Fudge Cake*!
Read ***ONLY*** if you really must give up trying to de-obfuscate!
## Author's remarks:
### Feature-rich curses implementation of the Snake game (with many gameplay modes and options)
@@ -614,6 +616,7 @@ email but I'm more likely to respond to mastodon messages.
[troubleshooting.html]: troubleshooting.html
[troubleshooting.md]: troubleshooting.md
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
2020/ferguson2/README.md
+6 -1
View File
@@ -12,6 +12,7 @@ Mastodon: [@xexyl@fosstodon.org](https://fosstodon.org/@xexyl)
make
```
## To use:
```sh
@@ -48,7 +49,8 @@ make
**NOTE**: in [recode](recode.c) no spaces between options and option arguments are allowed.
## Try:
### Try:
```sh
# IOCCC obfuscated!
@@ -92,6 +94,7 @@ echo | ./recode -v
do?
## Judges' remarks:
This code is an [enigma](https://youtu.be/ybkkiGtJmkM). Try to decode it!
@@ -118,6 +121,7 @@ There is a good deal of useful documentation that is provided with this entry:
[recode.html]: recode.html
[chocolate-cake.html]: chocolate-cake.html
## Author's remarks:
My remarks about my [Heer][] (army) and [Luftwaffe][] (air force) [Enigma
@@ -920,6 +924,7 @@ email but I'm more likely to respond to mastodon messages.
[Luftwaffe]: https://en.wikipedia.org/wiki/Luftwaffe
[Enigma]: https://www.cryptomuseum.com/crypto/enigma/index.htm
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
2020/giles/README.md
+7 -1
View File
@@ -3,19 +3,22 @@
Edward Giles\
<https://id523a.com/>
## To build:
```sh
make
```
## To use:
```sh
./prog
```
## Try:
### Try:
```sh
./prog < pi.wav
@@ -26,10 +29,12 @@ make
# Use an audio player to play jenny.wav
```
## Judges' remarks:
A cross platform utility for both encoding and decoding tones.
## Author's remarks:
### Introduction and Usage
@@ -98,6 +103,7 @@ This program determines which frequencies are present in the input by passing it
Tones are generated using those same resonators by providing [an impulse](https://en.wikipedia.org/wiki/Kronecker_delta#Digital_signal_processing) as input. An impulse can be thought of as consisting of sine-waves at all frequencies, and when it is put through one of the resonators, the result is a single pure sine wave.
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
2020/kurdyukov1/README.md
+7 -1
View File
@@ -3,19 +3,22 @@
Ilya Kurdyukov\
<https://github.com/ilyakurdyukov>
## To build:
```sh
make
```
## To use:
```sh
./prog
```
## Try:
### Try:
```sh
echo IOCCC | ./prog
@@ -37,12 +40,14 @@ make alt
Use `prog.alt` as you would `prog` above.
## Judges' remarks:
This hash of a C code makes a hash out of input.
Do you understand how?
You should get a-round-to-it figuring it out!
## Author's remarks:
### MD5 with integers
@@ -77,6 +82,7 @@ Added a macro hack to make stdin work in binary mode under Windows (tested under
- `prog.x86.asm` and for x86, although the headers are smaller, but the binary code is larger due to fewer registers and lack of 64-bit multiply.
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
2020/kurdyukov2/README.md
+8 -1
View File
@@ -3,19 +3,22 @@
Ilya Kurdyukov\
<https://github.com/ilyakurdyukov>
## To build:
```sh
make
```
## To use:
```sh
./prog
```
## Try:
### Try:
```sh
# Take a selfie
@@ -31,6 +34,7 @@ for i in 0001 0002 0004 0008 0016 0032 0064 0128 0256 0512 1024 2048 4096 8192 ;
# Then flip through the out*.jpg pictures and see when you start recognizing the image.
``
## Judges' remarks:
This entry has reminded us of a winning entry back in the early 90s. Can you guess which one?
@@ -38,7 +42,9 @@ This entry has reminded us of a winning entry back in the early 90s. Can you gue
For a given image, try graphing the execution time relative to the number of rectangles.
What is the complexity? Is it obvious from the source code?
## Author's remarks:
### Usage
This program divides the image into a specified number of rectangles. This process is content aware, so algorithm tries to match most of the information. However, it doesn't find the best theoretically possible layout.
@@ -143,6 +149,7 @@ convert -delay 10 -dither none -loop 0 $(ls out*.jpg | sort -V) $(ls out*.jpg |
Also provided `makegif.sh` to aid with GIF creation.
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
2020/kurdyukov3/README.md
+7 -1
View File
@@ -3,19 +3,22 @@
Ilya Kurdyukov\
<https://github.com/ilyakurdyukov>
## To build:
```sh
make
```
## To use:
```sh
./prog
```
## Try:
### Try:
```sh
# first input to try
@@ -40,6 +43,7 @@ make alt
Use `prog.alt` as you would `prog` above.
## Judges' remarks:
It is interesting how well smeonoe can raed txet wtih lots of tyops in it.
@@ -53,6 +57,7 @@ languages) is called
jumbled or if other words were formed one could not read it: we know of some who
can in fact do exactly that).
## Author's remarks:
### Letter Mixer ###
@@ -65,6 +70,7 @@ cat input.txt | ./prog
The program can work with letters that are not represented in English, as long as these letters are encoded in the higher part of the single-byte character set (use `iconv` to convert from UTF-8 and back).
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
2020/kurdyukov4/README.md
+7 -1
View File
@@ -3,19 +3,22 @@
Ilya Kurdyukov\
<https://github.com/ilyakurdyukov>
## To build:
```sh
make
```
## To use:
```sh
./prog text_file output_length context_length random_seed
```
## Try:
### Try:
```sh
./prog Shakespeare.txt 2000 10 1
@@ -31,6 +34,7 @@ make
> Too many identical strings if the context length is small.
> -- Author
## Judges' remarks:
We were able to write our own program performing the same trick using the (still
@@ -63,6 +67,7 @@ volume X of [History of Middle-earth
(HoMe)](https://en.wikipedia.org/wiki/The_History_of_Middle-earth). Now can you
appreciate the award title a bit better?
## Author's remarks:
### Building:
@@ -140,6 +145,7 @@ ster lieutenant comes. Master lieutenant, pray you,-- CORIOLANUS: What's that to
him? CHRISTOPHER: At Pembroke, Sir James Blunt, And Rice ap Thomas with a virtu
```
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
2020/otterness/README.md
+7 -1
View File
@@ -3,19 +3,22 @@
Nathan Otterness\
<https://github.com/yalue>
## To build:
```sh
make
```
## To use:
```sh
./prog
```
## Try:
### Try:
```sh
wget -O cvikl.mid 'http://www.kunstderfuge.com/-/midi.asp?file=beethoven/symphony_6_1_(c)cvikl.mid'
@@ -27,6 +30,7 @@ wget -O entertainer.mid https://www.midiworld.com/download/3857
# Play output.mid with your favorite player
```
## Judges' remarks:
In an entry that boasts not using literals, one would expect to see straightforward ways to produce
@@ -35,6 +39,7 @@ apart from reading stdin and writing to stdout, would take a while.
While doing that, you can be audibly *entertained* by a sample of its output.
## Author's remarks:
### MIDI "boots and cats"
@@ -144,6 +149,7 @@ codes can be interpreted as follows:
- `10`: The input file's MIDI header was incorrect (but this isn't checked
very thoroughly).
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
2020/tsoj/README.md
+7 -1
View File
@@ -3,19 +3,22 @@
tsoj <tsoj.tsoj@gmx.de>\
<https://gitlab.com/tsoj>
## To build:
```sh
make
```
## To use:
```sh
./prog
```
## Try:
### Try:
```sh
# Make your terminal as large as possible, possibly reduce your font size
@@ -23,6 +26,7 @@ make
./prog
```
## Judges' remarks:
This game does not use curses, but you may end up cursing.
@@ -30,6 +34,7 @@ This game does not use curses, but you may end up cursing.
The code is made more difficult to read using an innovative, right justified,
reverse indentation style.
## Author's remarks:
#### Controls
@@ -96,6 +101,7 @@ My best was **156**. If you beat that I'll send you the image of a very expensiv
- Adjust your terminal size for different experiences
- Run this program in a virtual console to immerse yourself in the game
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
2020/yang/README.md
+7 -1
View File
@@ -3,19 +3,22 @@
Don Yang\
<http://uguu.org/>
## To build:
```sh
make
```
## To use:
```sh
./prog [PIN] < input.txt > output.c
```
## Try:
### Try:
```sh
echo "International Obfuscated C Code Contest 2020" | ./prog 23209 > code.c
@@ -35,6 +38,7 @@ cc -DPIN=23209 code.c -o decoded # wait for it ...
# weeeeeeeeeeeeee! You are having a good time!
```
## Judges' remarks:
You might think of this entry as code obfuscater with a code.
@@ -45,6 +49,7 @@ What is compiling this entry about?
This winning entry also comes with a [JavaScript timelapse
spoiler](spoiler.html) that shows how this entry was written.
## Author's remarks:
### Synopsis
@@ -145,6 +150,7 @@ with this entry to preprocess the generated output to make them more
acceptable to typical compilers. View the [cppp.cc](cppp.cc) source and
then compile it with a c++ compiler of your choice.
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.