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

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

No files matched your search

+7 -1
View File
@@ -4,19 +4,22 @@ Don Yang\
<omoikane@uguu.org>\
<http://uguu.org/>
## To build:
```sh
make
```
## To use:
```sh
./akari [ input_file | - ] [ output_file | - ] [even]
```
## Try:
### Try:
```sh
./akari < example.ppm > odd_output.ppm
@@ -46,6 +49,7 @@ You can automate the above by running:
./try.sh
```
## Judges' remarks:
`Akari` is an image downsampling utility that accepts 3 input formats:
@@ -65,6 +69,7 @@ lines](https://en.wikipedia.org/wiki/Newline) in LF bytes only, _**not** CRLF_!)
Anything that is not parsable as `PGM` or `PPM` will be downsampled as ASCII art.
## Author's remarks:
`Akari` is an image downsampling utility. She accepts up to 3 arguments:
@@ -151,6 +156,7 @@ C program 4 levels deep, it's much easier to interleave something like
a `brainf#$%` program in a C program, for example. For comparison, a
`brainf#$%` program is embedded inside [akari.c](akari.c).
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
+7 -1
View File
@@ -4,12 +4,14 @@ Philip Blakely\
Cambridge, UK\
<pmblakely@gmail.com>
## To build:
```sh
make
```
## To use:
Zoom out and make your terminal window 53 or more lines deep.
@@ -18,7 +20,8 @@ Zoom out and make your terminal window 53 or more lines deep.
./blakely < blakely.c | head -300
```
## Try:
### Try:
```sh
./blakely < 3.dat | head -100
@@ -27,6 +30,7 @@ Zoom out and make your terminal window 53 or more lines deep.
./blakely < t0_3.dat
```
## Judges' remarks:
This program plays [Life](https://en.wikipedia.org/wiki/Conway%27s_Game_of_Life)
@@ -41,6 +45,7 @@ and run:
./blakely - < garden.txt
```
## Author's remarks:
This program uses a well-known algorithm in order to display pi to
@@ -224,6 +229,7 @@ universe.
The command `./blakely - < blakely.c` is therefore *not* recommended.
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
+7 -1
View File
@@ -4,19 +4,22 @@ Szabolcs Borsanyi\
Germany\
<borsanyi@uni-wuppertal.de>
## To build:
```sh
make
```
## To use:
```sh
./borsanyi < some_data_file
```
## Try:
### Try:
```sh
./borsanyi < data.1
@@ -24,6 +27,7 @@ make
./borsanyi < data.3
```
## Judges' remarks:
This is a nice quick [histogram](https://en.wikipedia.org/wiki/Histogram)
@@ -43,6 +47,7 @@ use `malloc(3)` or `alloca(3)`. How does it build the histogram?
While the input does not need to be sorted, the histogram output is sorted.
How does it put the data into buckets? Why does it `fork()` 22 times?
## Author's remarks:
This small piece of program is meant to be a useful tool, when
@@ -75,6 +80,7 @@ great help.
* Multi-process approach for optimal use of resources.
* Some bin size obfuscation.
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
+7 -2
View File
@@ -5,6 +5,7 @@ US\
<j.david.lowe@gmail.com>\
<https://github.com/dlowe>
## To build:
```sh
@@ -12,7 +13,7 @@ make
```
### Bugs and (Mis)features
### Bugs and (Mis)features:
The current status of this entry is:
@@ -38,7 +39,8 @@ Then to use `trained.net`:
./dlowe file [file ...] < trained.net
```
## Try:
### Try:
Try these pre-trained networks:
@@ -65,6 +67,7 @@ NOTE: The `dlowe-aux-data/` directory was created by:
tar -jxf dlowe-aux-data.tar.bz2
```
## Judges' remarks:
This entry is a ghoulish example of a brain (dead?) neural network classifier.
@@ -177,6 +180,7 @@ We created the [xor-trained.net](dlowe-aux-data/xor-trained.net) as follows:
**NOTE**: The directory args **must end in a** `/` for them to work.
## Author's remarks:
### Synopsis
@@ -343,6 +347,7 @@ by a network trained to recognize [IOCCC winners](/winners.html) ;)
... but mostly zombies!
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
+1 -1
View File
@@ -18,7 +18,7 @@ make
```
## Try:
### Try:
Quit the program. Resize your terminal window. Run it again.
+7 -1
View File
@@ -3,19 +3,22 @@
Kimmo Fredriksson\
<kimmo.k.k.fredriksson@gmail.com>
## To build:
```sh
make
```
## To use:
```sh
./fredriksson [-icvtnk#] regexp < file
```
## Try:
### Try:
```sh
./fredriksson -k1 -i POOT < /etc/group
@@ -26,6 +29,7 @@ ulimit -s unlimited
NOTE: you need to be allowed to change your stack size or else the last command
will likely cause the program to dump core.
## Judges' remarks:
The author of this entry was making sure that it does not win the "Best Short
@@ -35,6 +39,7 @@ transform](https://en.wikipedia.org/wiki/Burrows-Wheeler_transform) decompressor
that produces the source code of the actual obfuscated approximate `grep`
program and calls it. As an exercise, try writing the compressor.
## Author's remarks:
### Approximate grep
@@ -280,6 +285,7 @@ Just say
if deleting even one of those chars breaks the program! (This does not
apply to the generated source `ag.c`.)
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
+1 -1
View File
@@ -18,7 +18,7 @@ echo "some text" | ./goren
```
## Try:
### Try:
```sh
echo "Hello, world!" | ./goren
+7 -1
View File
@@ -3,19 +3,22 @@
Shinichiro Hamaji\
<shinichiro.hamaji@gmail.com>
## To build:
```sh
make
```
## To use:
```sh
./hamaji < a_nonogram_file
```
## Try:
### Try:
```sh
./hamaji < dragon.nono
@@ -27,6 +30,7 @@ make
./hamaji < samurai.nono
```
## Judges' remarks:
This program solves "Nonogram", which also known as "Paint by Numbers":
@@ -44,6 +48,7 @@ NOTE: NONOGRAM (r) is a registered Trademark and is used with permission. See
<https://web.archive.org/web/20110128130704/http://nonogram.com/> for more
information.
## Author's remarks:
The format of the input files are as same as this site:
@@ -227,6 +232,7 @@ You can reproduce [dragon.nono](dragon.nono) from [hamaji.c](hamaji.c) using
perl c2nono.pl hamaji.c | ./hamaji
```
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
+7 -1
View File
@@ -3,19 +3,22 @@
Hou Qiming\
<hqm03ster@gmail.com>
## To build:
```sh
make
```
## To use:
```sh
./hou 'expression'
```
## Try:
### Try:
```sh
./hou '11/26+222/31'
@@ -29,6 +32,7 @@ make
What does the last one mean?
## Judges' remarks:
This self-documenting scientific calculator compiles clean with no
@@ -81,6 +85,7 @@ The parser is functionally equivalent to a normal arithmetic parser for all
valid inputs. For another fun challenge: try to determine how it parses the
command line argument.
## Author's remarks:
### Obfuscations
@@ -119,6 +124,7 @@ Both hash functions were found using a separate search program. Another program
was used to find a way to format one hash function as example input such that
it produces something resembling the bitmask hash table as part of its output.
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
+7 -1
View File
@@ -4,19 +4,22 @@ Taketo Konno\
Japan\
<inaniwa3@gmail.com>
## To build:
```sh
make
```
## To use:
```sh
./konno lower_case_word
```
## Try:
### Try:
```sh
./konno qwerty
@@ -24,6 +27,7 @@ make
./konno "the quick brown fox jumps over the lazy dog"
```
## Judges' remarks:
This tiny program outputs what looks like a tiny keyboard.\
@@ -39,6 +43,7 @@ how this program works and does what it does. Can you
extend this program to deal with a full QWERTY keyboard?
Can you then minimize the size of that code?
## Author's remarks:
### Limitation
@@ -50,6 +55,7 @@ This program ignores non-lower case letters.
* `for` is not used.\
* A part of the program is encrypted.
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
+2 -2
View File
@@ -11,7 +11,7 @@ make
```
### Bugs and (Mis)features
### Bugs and (Mis)features:
The current status of this entry is:
@@ -29,7 +29,7 @@ For more detailed information see [2011 richards in bugs.md](/bugs.md#2011-richa
```
## Try:
### Try:
```sh
echo '10 9 8 7 6 5 4 3 2 1*p*p*p*p*p*p*p*p*p' | ./richards
+7 -1
View File
@@ -5,12 +5,14 @@ Mexico\
<biyubi@gmail.com>\
<https://nanochess.org>
## To build:
```sh
make
```
## To use:
```sh
@@ -20,12 +22,14 @@ make
NOTE: This requires X11 to run or modifications to use [layer.c](layer.c) on
Windows (see below).
## Try:
### Try:
```sh
echo "Do or do not. There is no try."
```
## Judges' remarks:
This two player game uses X11. The control keys can be configured by
@@ -44,6 +48,7 @@ you remove both the X11 include files and replace them with
\
you ought to be able to compile and run this program on Windows.
## Author's remarks:
```
@@ -234,6 +239,7 @@ another program.
*Have fun!*
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
+2 -2
View File
@@ -12,7 +12,7 @@ make
```
### Bugs and (Mis)features
### Bugs and (Mis)features:
The current status of this entry is:
@@ -39,7 +39,7 @@ program though we note that your computer might also [halt and catch
fire](https://en.wikipedia.org/wiki/Halt_and_Catch_Fire_(computing)) :-)
## Try:
### Try:
```sh
./vik randowan.mod | mplayer -demuxer rawaudio -
+7 -1
View File
@@ -4,19 +4,22 @@ Matt Zucker\
<mzucker1@swarthmore.edu>\
<https://mzucker.github.io/swarthmore/>
## To build:
```sh
make
```
## To use:
```sh
./zucker > image.ppm
```
## Try:
### Try:
```sh
./zucker "Hello\!\!\!" > hello.ppm
@@ -34,6 +37,7 @@ open image.ppm
which will open `Preview.app` which will let you look at the image no problem.
No need to install additional software.
## Judges' remarks:
The rendered image is centered and is output as a 600 by 220 pixel PPM.
@@ -41,6 +45,7 @@ The vector font is proportional.
This entry uses no local variables. None! At! All!
## Author's remarks:
### An image generator
@@ -176,6 +181,7 @@ were not submitted as entries for this year's IOCCC, not because they
lack obfuscation, but because neither is written in C (they are in C++
and Python, respectively).
## Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.