From fbd20cfdc2ef002b421d7c88cbbbd82956f6c478 Mon Sep 17 00:00:00 2001 From: Landon Curt Noll Date: Thu, 2 Nov 2023 15:45:36 -0700 Subject: [PATCH] fix standard headers and header spacing in winner README.md files --- 1984/anonymous/README.md | 5 +++++ 1984/decot/README.md | 5 ++++- 1984/laman/README.md | 5 ++++- 1984/mullender/README.md | 6 ++---- 1985/applin/README.md | 7 ++++++- 1985/august/README.md | 7 ++++++- 1985/lycklama/README.md | 9 +++++++-- 1985/shapiro/README.md | 6 +++++- 1985/sicherman/README.md | 7 ++++++- 1986/applin/README.md | 8 ++++++-- 1986/august/README.md | 7 +++++-- 1986/bright/README.md | 8 +++++++- 1986/hague/README.md | 7 ++++++- 1986/holloway/README.md | 6 +++++- 1986/marshall/README.md | 5 +++-- 1986/pawka/README.md | 7 ++++++- 1986/stein/README.md | 5 +++++ 1986/wall/README.md | 5 +++++ 1987/biggar/README.md | 6 +++++- 1987/heckbert/README.md | 8 +++++++- 1987/hines/README.md | 7 ++++++- 1987/korn/README.md | 4 ++++ 1987/lievaart/README.md | 6 +++++- 1987/wall/README.md | 5 +++-- 1987/westley/README.md | 3 +++ 1988/applin/README.md | 4 +++- 1988/dale/README.md | 8 +++++--- 1988/isaak/README.md | 4 ++++ 1988/litmaath/README.md | 6 +++++- 1988/phillipps/README.md | 2 ++ 1988/reddy/README.md | 6 ++++-- 1988/robison/README.md | 6 +++++- 1988/spinellis/README.md | 6 +++++- 1988/westley/README.md | 5 +++-- 1989/fubar/README.md | 8 ++++++-- 1989/jar.1/README.md | 4 ++++ 1989/jar.2/README.md | 5 ++++- 1989/ovdluhe/README.md | 7 +++++-- 1989/paul/README.md | 6 +++++- 1989/robison/README.md | 9 +++++++-- 1989/roemer/README.md | 7 ++++++- 1989/tromp/README.md | 7 ++++++- 1989/vanb/README.md | 6 ++++-- 1989/westley/README.md | 7 ++++--- 1990/baruch/README.md | 6 +++++- 1990/cmills/README.md | 7 +++++-- 1990/dds/README.md | 6 +++++- 1990/dg/README.md | 6 +++++- 1990/jaw/README.md | 8 +++++--- 1990/pjr/README.md | 4 ++++ 1990/stig/README.md | 7 ++++++- 1990/tbr/README.md | 4 +++- 1990/theorem/README.md | 5 +++-- 1990/westley/README.md | 3 ++- 1991/ant/README.md | 8 +++++++- 1991/brnstnd/README.md | 2 +- 1991/buzzard/README.md | 5 +++++ 1991/cdupont/README.md | 5 +++++ 1991/davidguy/README.md | 7 +++++-- 1991/dds/README.md | 4 ++-- 1991/fine/README.md | 7 +++++-- 1991/rince/README.md | 5 +++++ 1991/westley/README.md | 5 +++-- 1992/adrian/README.md | 3 ++- 1992/albert/README.md | 9 ++++++++- 1992/ant/README.md | 6 ++++-- 1992/buzzard.1/README.md | 6 +++++- 1992/buzzard.2/README.md | 5 +++++ 1992/gson/README.md | 3 +-- 1992/imc/README.md | 5 +++++ 1992/kivinen/README.md | 6 +++--- 1992/lush/README.md | 2 +- 1992/marangon/README.md | 5 +++++ 1992/nathan/README.md | 9 +++++++-- 1992/vern/README.md | 7 ++++++- 1992/westley/README.md | 3 ++- 1993/ant/README.md | 8 +++++++- 1993/cmills/README.md | 5 +++++ 1993/dgibson/README.md | 9 ++++++++- 1993/ejb/README.md | 7 ++++++- 1993/leo/README.md | 1 + 1993/lmfjyh/README.md | 3 ++- 1993/plummer/README.md | 3 ++- 1993/rince/README.md | 1 + 1993/schnitzi/README.md | 2 +- 1993/vanb/README.md | 3 ++- 1994/dodsond1/README.md | 5 +++++ 1994/dodsond2/README.md | 5 +++++ 1994/horton/README.md | 3 +++ 1994/imc/README.md | 7 ++++++- 1994/ldb/README.md | 4 ++-- 1994/schnitzi/README.md | 6 ++---- 1994/shapiro/README.md | 4 ++-- 1994/smr/README.md | 8 +++++++- 1994/tvr/README.md | 7 ++++++- 1994/weisberg/README.md | 3 +++ 1994/westley/README.md | 2 +- 1995/cdua/README.md | 6 +++--- 1995/dodsond1/README.md | 8 +++++++- 1995/dodsond2/README.md | 5 +++++ 1995/esde/README.md | 6 +++++- 1995/garry/README.md | 5 ++--- 1995/heathbar/README.md | 9 +++++++-- 1995/leo/README.md | 6 +++++- 1995/makarios/README.md | 5 +++++ 1995/savastio/README.md | 8 +++++++- 1995/schnitzi/README.md | 9 +++++++-- 1995/spinellis/README.md | 5 ++++- 1995/vanschnitz/README.md | 7 +++++-- 1996/august/README.md | 4 ++-- 1996/dalbec/README.md | 3 ++- 1996/eldby/README.md | 4 +++- 1996/gandalf/README.md | 5 +++-- 1996/huffman/README.md | 7 ++++++- 1996/jonth/README.md | 10 +++++++--- 1996/rcm/README.md | 8 +++++++- 1996/schweikh1/README.md | 7 ++++++- 1996/schweikh2/README.md | 6 ++++-- 1996/schweikh3/README.md | 5 +++++ 1996/westley/README.md | 2 +- 1998/banks/README.md | 5 +++++ 1998/bas1/README.md | 7 ++++++- 1998/bas2/README.md | 5 +++++ 1998/chaos/README.md | 1 - 1998/df/README.md | 4 ++++ 1998/dlowe/README.md | 9 +++++++-- 1998/dloweneil/README.md | 7 +++++-- 1998/dorssel/README.md | 8 +++++++- 1998/fanf/README.md | 5 +++++ 1998/schnitzi/README.md | 4 ++-- 1998/schweikh1/README.md | 1 + 1998/schweikh2/README.md | 6 ++++-- 1998/schweikh3/README.md | 10 +++++++--- 1998/tomtorfs/README.md | 8 +++++++- 2000/anderson/README.md | 2 +- 2000/bellard/README.md | 7 ++++++- 2000/bmeyer/README.md | 9 ++++++++- 2000/briddlebane/README.md | 3 ++- 2000/dhyang/README.md | 8 +++++++- 2000/dlowe/README.md | 3 ++- 2000/jarijyrki/README.md | 2 +- 2000/natori/README.md | 2 +- 2000/primenum/README.md | 5 +++-- 2000/rince/README.md | 9 +++++++-- 2000/robison/README.md | 8 +++++++- 2000/schneiderwent/README.md | 8 +++++++- 2000/thadgavin/README.md | 2 +- 2000/tomx/README.md | 8 +++++++- 2001/anonymous/README.md | 5 +++-- 2001/bellard/README.md | 4 ++-- 2001/cheong/README.md | 3 ++- 2001/coupard/README.md | 2 +- 2001/ctk/README.md | 2 +- 2001/dgbeards/README.md | 4 ++-- 2001/herrmann1/README.md | 7 +++++-- 2001/herrmann2/README.md | 3 ++- 2001/jason/README.md | 8 +++++++- 2001/kev/README.md | 5 ++--- 2001/ollinger/README.md | 9 +++++++-- 2001/rosten/README.md | 8 +++++++- 2001/schweikh/README.md | 9 +++++++-- 2001/westley/README.md | 2 +- 2001/williams/README.md | 8 +++++++- 2004/anonymous/README.md | 7 ++++++- 2004/arachnid/README.md | 2 +- 2004/burley/README.md | 3 ++- 2004/gavare/README.md | 8 ++++++-- 2004/gavin/README.md | 4 ++-- 2004/hibachi/README.md | 8 +++++++- 2004/hoyle/README.md | 8 +++++++- 2004/jdalbec/README.md | 8 +++++++- 2004/kopczynski/README.md | 2 +- 2004/newbern/README.md | 2 +- 2004/omoikane/README.md | 8 +++++++- 2004/schnitzi/README.md | 7 ++++++- 2004/sds/README.md | 9 +++++++-- 2004/vik1/README.md | 8 +++++++- 2004/vik2/README.md | 8 +++++++- 2005/aidan/README.md | 2 +- 2005/anon/README.md | 4 ++-- 2005/boutines/README.md | 7 ++++++- 2005/chia/README.md | 8 +++++++- 2005/giljade/README.md | 4 ++-- 2005/jetro/README.md | 7 ++++++- 2005/klausler/README.md | 8 +++++++- 2005/mikeash/README.md | 8 +++++++- 2005/mynx/README.md | 4 ++-- 2005/persano/README.md | 9 +++++++-- 2005/sykes/README.md | 8 +++++++- 2005/timwi/README.md | 8 +++++++- 2005/toledo/README.md | 8 +++++++- 2005/vik/README.md | 8 +++++++- 2005/vince/README.md | 8 +++++++- 2006/birken/README.md | 2 +- 2006/borsanyi/README.md | 2 +- 2006/grothe/README.md | 6 +++++- 2006/hamre/README.md | 7 ++++++- 2006/meyer/README.md | 8 +++++++- 2006/monge/README.md | 4 ++-- 2006/night/README.md | 2 +- 2006/sloane/README.md | 4 +++- 2006/stewart/README.md | 6 +++++- 2006/sykes1/README.md | 7 ++++++- 2006/sykes2/README.md | 7 ++++++- 2006/toledo1/README.md | 7 ++++++- 2006/toledo2/README.md | 5 +++-- 2006/toledo3/README.md | 2 +- 2011/akari/README.md | 8 +++++++- 2011/blakely/README.md | 8 +++++++- 2011/borsanyi/README.md | 8 +++++++- 2011/dlowe/README.md | 9 +++++++-- 2011/eastman/README.md | 2 +- 2011/fredriksson/README.md | 8 +++++++- 2011/goren/README.md | 2 +- 2011/hamaji/README.md | 8 +++++++- 2011/hou/README.md | 8 +++++++- 2011/konno/README.md | 8 +++++++- 2011/richards/README.md | 4 ++-- 2011/toledo/README.md | 8 +++++++- 2011/vik/README.md | 4 ++-- 2011/zucker/README.md | 8 +++++++- 2012/blakely/README.md | 8 +++++++- 2012/deckmyn/README.md | 8 +++++++- 2012/dlowe/README.md | 7 ++++++- 2012/endoh1/README.md | 8 +++++++- 2012/endoh2/README.md | 8 +++++++- 2012/grothe/README.md | 8 +++++++- 2012/hamano/README.md | 8 +++++++- 2012/hou/README.md | 8 +++++++- 2012/kang/README.md | 4 +++- 2012/konno/README.md | 8 +++++++- 2012/omoikane/README.md | 8 +++++++- 2012/tromp/README.md | 3 ++- 2012/vik/README.md | 4 ++-- 2012/zeitak/README.md | 10 ++++++++-- 2013/birken/README.md | 6 +++++- 2013/cable1/README.md | 8 +++++++- 2013/cable2/README.md | 8 +++++++- 2013/cable3/README.md | 4 ++-- 2013/dlowe/README.md | 7 +++++-- 2013/endoh1/README.md | 8 ++++++-- 2013/endoh2/README.md | 9 ++++++++- 2013/endoh3/README.md | 7 ++++++- 2013/endoh4/README.md | 7 ++++++- 2013/hou/README.md | 9 +++++++-- 2013/mills/README.md | 8 +++++++- 2013/misaka/README.md | 8 +++++++- 2013/morgan1/README.md | 8 +++++++- 2013/morgan2/README.md | 8 +++++++- 2013/robison/README.md | 8 +++++++- 2014/birken/README.md | 7 ++++++- 2014/deak/README.md | 7 ++++++- 2014/endoh1/README.md | 7 ++++++- 2014/endoh2/README.md | 8 +++++++- 2014/maffiodo1/README.md | 2 +- 2014/maffiodo2/README.md | 8 +++++++- 2014/morgan/README.md | 8 +++++++- 2014/sinon/README.md | 8 +++++++- 2014/skeggs/README.md | 8 +++++++- 2014/vik/README.md | 5 +++-- 2014/wiedijk/README.md | 8 +++++++- 2015/burton/README.md | 8 +++++++- 2015/dogon/README.md | 8 +++++++- 2015/duble/README.md | 7 ++++++- 2015/endoh1/README.md | 7 ++++++- 2015/endoh2/README.md | 8 +++++++- 2015/endoh3/README.md | 4 +++- 2015/endoh4/README.md | 8 +++++++- 2015/hou/README.md | 8 +++++++- 2015/howe/README.md | 8 +++++++- 2015/mills1/README.md | 8 +++++++- 2015/mills2/README.md | 8 +++++++- 2015/muth/README.md | 8 +++++++- 2015/schweikhardt/README.md | 8 +++++++- 2015/yang/README.md | 2 +- 2018/algmyr/README.md | 9 +++++++-- 2018/anderson/README.md | 8 +++++++- 2018/bellard/README.md | 8 +++++++- 2018/burton1/README.md | 8 +++++++- 2018/burton2/README.md | 8 +++++++- 2018/ciura/README.md | 7 ++++++- 2018/endoh1/README.md | 8 +++++++- 2018/endoh2/README.md | 9 +++++++-- 2018/ferguson/README.md | 8 +++++++- 2018/giles/README.md | 7 ++++++- 2018/hou/README.md | 9 +++++++-- 2018/mills/README.md | 7 ++++++- 2018/poikola/README.md | 2 +- 2018/vokes/README.md | 8 +++++++- 2018/yang/README.md | 8 +++++++- 2019/adamovsky/README.md | 8 +++++++- 2019/burton/README.md | 8 +++++++- 2019/ciura/README.md | 4 ++-- 2019/diels-grabsch1/README.md | 2 +- 2019/diels-grabsch2/README.md | 2 +- 2019/dogon/README.md | 8 +++++++- 2019/duble/README.md | 9 +++++++-- 2019/endoh/README.md | 9 +++++++-- 2019/giles/README.md | 8 +++++++- 2019/karns/README.md | 2 +- 2019/lynn/README.md | 8 +++++++- 2019/mills/README.md | 8 +++++++- 2019/poikola/README.md | 9 +++++++-- 2019/yang/README.md | 8 +++++++- 2020/burton/README.md | 8 ++++++-- 2020/carlini/README.md | 8 +++++++- 2020/endoh1/README.md | 8 +++++++- 2020/endoh2/README.md | 8 +++++++- 2020/endoh3/README.md | 8 +++++++- 2020/ferguson1/README.md | 9 ++++++--- 2020/ferguson2/README.md | 7 ++++++- 2020/giles/README.md | 8 +++++++- 2020/kurdyukov1/README.md | 8 +++++++- 2020/kurdyukov2/README.md | 9 ++++++++- 2020/kurdyukov3/README.md | 8 +++++++- 2020/kurdyukov4/README.md | 8 +++++++- 2020/otterness/README.md | 8 +++++++- 2020/tsoj/README.md | 8 +++++++- 2020/yang/README.md | 8 +++++++- 319 files changed, 1601 insertions(+), 382 deletions(-) diff --git a/1984/anonymous/README.md b/1984/anonymous/README.md index 08320a3cb..8a862be10 100644 --- a/1984/anonymous/README.md +++ b/1984/anonymous/README.md @@ -2,12 +2,14 @@ Anonymous + ## To build: ```sh make all ``` + ## To use: ```sh @@ -35,6 +37,7 @@ NOTE: this version might not work on some systems like macOS. ./anonymous.alt ``` + ## Judges' remarks: The author was too embarrassed that they could write such trash, so I @@ -52,6 +55,7 @@ the code, this is what it looks like: ![1984-anonymous-tattoo.jpg](1984-anonymous-tattoo.jpg) + ## Author's remarks: ### On remaining anonymous: @@ -83,6 +87,7 @@ have started with main). On the other hand the author likes the "two line look" and the way `hell o` was split. :-) And they like the fact that it ends in a smily face: `;}`. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1984/decot/README.md b/1984/decot/README.md index 405f8f1a9..447258955 100644 --- a/1984/decot/README.md +++ b/1984/decot/README.md @@ -2,6 +2,7 @@ Dave Decot + ## To build: ```sh @@ -13,7 +14,7 @@ you have an old enough compiler or a compiler that supports `-traditional-cpp`. The original code was fixed in 2023 to not require this. -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -48,6 +49,7 @@ make alt ./decot.alt ``` + ## Judges' remarks: This program prints out a string of garbage. @@ -83,6 +85,7 @@ for(signal=0;*k *= * __FILE__ *i;) do { No remarks were provided by the author. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1984/laman/README.md b/1984/laman/README.md index 93382da10..8b979d718 100644 --- a/1984/laman/README.md +++ b/1984/laman/README.md @@ -17,7 +17,7 @@ make all ``` -## Try: +### Try: The program accepts ONE POSITIVE number. Seeing is believing, so try things like: @@ -30,6 +30,7 @@ like: This code should run you in circles. + ## Judges' remarks: Some new compilers (in 1984) dislike lines 6 and 10 of the source, so we changed @@ -49,10 +50,12 @@ to: I hope you have a C beautifier! + ## Author's remarks: No remarks were provided by the author. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1984/mullender/README.md b/1984/mullender/README.md index d907a30c2..827fcbd79 100644 --- a/1984/mullender/README.md +++ b/1984/mullender/README.md @@ -19,7 +19,7 @@ to use the alt version instead. See [original code](#original-code) below for the original version. -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -54,7 +54,6 @@ which is probably not as uncommon as you think :-). ### Try: - ```sh ./mullender.alt @@ -67,7 +66,7 @@ which is probably not as uncommon as you think :-). ./mullender.alt 100000 ./mullender.alt2 500 -# wait for 500 microseconds and see what happens +\# wait for 500 microseconds and see what happens ``` What happens if you hit enter after it reaches the end of the line? Why? What @@ -84,7 +83,6 @@ machine dependent code was discouraged. ### Original build: - ```sh make all ``` diff --git a/1985/applin/README.md b/1985/applin/README.md index 6f1937eb1..582648b55 100644 --- a/1985/applin/README.md +++ b/1985/applin/README.md @@ -4,27 +4,32 @@ Jack Applin [with help from Robert Heckendorn]\ US\ + ## To build: ```sh make all ``` -## Try: + +### Try: ```sh ./applin ``` + ## Judges' remarks: One liner programs are short but twisted. This "Hello, world!" version certainly takes its time saying hello. + ## Author's remarks: No remarks were provided by the author. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1985/august/README.md b/1985/august/README.md index 7d8443304..bfbb6686a 100644 --- a/1985/august/README.md +++ b/1985/august/README.md @@ -3,19 +3,22 @@ Lennart Augustsson\ + ## To build: ```sh make all ``` + ## To use: ```sh ./august ``` -## Try: + +### Try: ```sh ./august | head -n 10 @@ -44,10 +47,12 @@ memory or until they sell your computer, whichever comes first. If you use the [primes.sh](primes.sh) script can you figure out if there's anything funny going on with the output? + ## Author's remarks: No remarks were provided by the author. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1985/lycklama/README.md b/1985/lycklama/README.md index 2c7a556c9..c6d6ff907 100644 --- a/1985/lycklama/README.md +++ b/1985/lycklama/README.md @@ -9,6 +9,7 @@ Ed Lycklama make alt ``` + ## To use: ```sh @@ -18,7 +19,8 @@ make alt To see why we recommend the alternate version instead of the original version, see below and the [original code](#original-code) section. -## Try: + +### Try: This alternate version, which we recommend you you try first, prior to the original, so that you can see what it does in modern systems, slows down the @@ -48,6 +50,7 @@ which would set it at 700. Then, whether you use the default value or not, try: ``` + ## Original code: As explained above, because modern systems run this entry way too fast to fully @@ -55,14 +58,15 @@ appreciate what it does, we encourage you to first try the alternate version. After this, however, you might wish to try the original version, fixed for modern systems. + ### Original build: ```sh make all ``` -### Original use: +### Original use: ```sh ./lycklama < some_file @@ -88,6 +92,7 @@ The program itself looks like tty noise. No remarks were provided by the author. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1985/shapiro/README.md b/1985/shapiro/README.md index afc4c46bf..8fc68feba 100644 --- a/1985/shapiro/README.md +++ b/1985/shapiro/README.md @@ -2,13 +2,15 @@ Carl Shapiro + ## To build: ```sh make all ``` -## Try: + +### Try: ```sh ./shapiro @@ -25,10 +27,12 @@ This program was selected for the 1987 t-shirt collection. We found this program is be simply a**maze**ing! Run this program without arguments and notice the output. + ## Author's remarks: No remarks were provided by the author. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1985/sicherman/README.md b/1985/sicherman/README.md index 6c04d8e11..a71605cfd 100644 --- a/1985/sicherman/README.md +++ b/1985/sicherman/README.md @@ -2,6 +2,7 @@ Col. G. L. Sicherman + ## To build: ```sh @@ -11,6 +12,7 @@ make all NOTE: there is an [alternate version](#alternate-code) for those who have an old enough compiler or have a compiler that supports the option `-traditional-cpp`. + ## To use: ```sh @@ -19,7 +21,8 @@ enough compiler or have a compiler that supports the option `-traditional-cpp`. echo foo | ./sicherman ``` -## Try: + +### Try: ```sh ./sicherman < sicherman.c @@ -55,6 +58,7 @@ make alt ./sicherman.alt < README.md | ./sicherman.alt ``` + ## Judges' remarks: This program abuses the C preprocessor so much that some `cpp`s fail to strip @@ -82,6 +86,7 @@ results in diff reporting a difference on some machines. No remarks were provided by the author. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1986/applin/README.md b/1986/applin/README.md index d78e5443c..cfd2d29d7 100644 --- a/1986/applin/README.md +++ b/1986/applin/README.md @@ -4,19 +4,22 @@ Jack Applin\ US\ + ## To build: ```sh make all ``` + ## To use: ```sh ./applin ``` -## Try: + +### Try: ```sh sh applin.c @@ -27,15 +30,16 @@ sh applin.c ## Judges' remarks: - The judges were so amused by this little program that we created an award just for it. This program is portable to the C and Fortran 77 compilers as well as executable by the Bourne shell! + ## Author's remarks: No remarks were provided by the author. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1986/august/README.md b/1986/august/README.md index f5301367c..9434ade1d 100644 --- a/1986/august/README.md +++ b/1986/august/README.md @@ -3,6 +3,7 @@ Lennart Augustsson\ + ## To build: ```sh @@ -10,7 +11,7 @@ make all ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -21,7 +22,7 @@ STATUS: INABIAF - please **DO NOT** fix For more detailed information see [1986 august in bugs.md](/bugs.md#1986-august). -## Try: +### Try: ```sh ./august @@ -38,10 +39,12 @@ dump. This program will pass lint on your system assuming your lint is brave enough to try and parse it correctly. + ## Author's remarks: No remarks were provided by the author. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1986/bright/README.md b/1986/bright/README.md index 532d7e766..9795ceaee 100644 --- a/1986/bright/README.md +++ b/1986/bright/README.md @@ -2,19 +2,22 @@ Walter Bright + ## To build: ```sh make all ``` + ## To use: ```sh ./bright some_file ``` -## Try: + +### Try: ```sh ./bright bright.c @@ -22,6 +25,7 @@ make all ./bright bright ``` + ## Judges' remarks: Compile this program and give a filename as an argument. @@ -31,10 +35,12 @@ excessive shifting to obfuscate an otherwise useful binary display program. This gives you a small example of what it is like to maintain the Bourne shell! :-} + ## Author's remarks: No remarks were provided by the author. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1986/hague/README.md b/1986/hague/README.md index 07e689cc5..b09b59b5b 100644 --- a/1986/hague/README.md +++ b/1986/hague/README.md @@ -3,12 +3,14 @@ Jim Hague\ UK + ## To build: ```sh make all ``` + ## To use: ```sh @@ -16,7 +18,8 @@ make all # enter some text ``` -## Try: + +### Try: ```sh ./hague 2>/dev/null @@ -45,10 +48,12 @@ similar variables can be obfuscating! The author noted that this program implements the international Morse standard. Now for extra credit, what Morse message does the program spell out? + ## Author's remarks: No remarks were provided by the author. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1986/holloway/README.md b/1986/holloway/README.md index 65aba351d..521ea2deb 100644 --- a/1986/holloway/README.md +++ b/1986/holloway/README.md @@ -3,13 +3,15 @@ Bruce Holloway\ US + ## To build: ```sh make all ``` -## Try: + +### Try: ```sh ./holloway @@ -23,10 +25,12 @@ performed in a very complex way. The judges and the author defy you to determine how it does it. It is a good thing that K&R didn't use this version as the first C program! + ## Author's remarks: No remarks were provided by the author. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1986/marshall/README.md b/1986/marshall/README.md index 95171d375..e070470e4 100644 --- a/1986/marshall/README.md +++ b/1986/marshall/README.md @@ -2,6 +2,7 @@ Eric Marshall + ## To build: ```sh @@ -17,7 +18,7 @@ might work but the other one would not. We describe this in more detail in if nothing else. -## Try: +### Try: ```sh ./marshall @@ -59,11 +60,11 @@ from printing a program! This program was selected for the 1987 t-shirt collection. - ## Author's remarks: No remarks were provided by the author. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1986/pawka/README.md b/1986/pawka/README.md index 3f6321b42..f0d2701ad 100644 --- a/1986/pawka/README.md +++ b/1986/pawka/README.md @@ -3,28 +3,33 @@ Michael H. Pawka\ US + ## To build: ```sh make all ``` -## Try: + +### Try: ```sh ./pawka ``` + ## Judges' remarks: The judges found this entry to be one of hardest to read without the aid of `/lib/cpp` and a good editor. When run, the program asks if it is obfuscated, of all things! + ## Author's remarks: No remarks were provided by the author. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1986/stein/README.md b/1986/stein/README.md index 3090713c4..5e5a9268e 100644 --- a/1986/stein/README.md +++ b/1986/stein/README.md @@ -2,18 +2,21 @@ Jan Stein + ## To build: ```sh make all ``` + ## To use: ```sh ./stein $(printf "\015\015"); echo ``` + ## Judges' remarks: NOTE: to avoid problems with news and mail, the single line was split @@ -33,10 +36,12 @@ to get the command to output cleanly: Your system may require another set of characters. In time, you will figure out what it does. :-) + ## Author's remarks: No remarks were provided by the author. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1986/wall/README.md b/1986/wall/README.md index 2b0e64b0e..469cd8c39 100644 --- a/1986/wall/README.md +++ b/1986/wall/README.md @@ -3,12 +3,14 @@ Larry Wall\ US + ## To build: ```sh make all ``` + ## To use: ```sh @@ -37,6 +39,7 @@ NOTE: gcc in macOS is actually clang even the binary `/usr/bin/gcc`. Use `./wall.alt` as you would `./wall`. + ## Judges' remarks: The original version did not have a ';' character in the first line. @@ -50,10 +53,12 @@ consider the warning message generated by the C compiler. Then execute the program and type characters into its standard input. You will see why the compiler documents the program. + ## Author's remarks: No remarks were provided by the author. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1987/biggar/README.md b/1987/biggar/README.md index d35f92bf1..b5fbf050e 100644 --- a/1987/biggar/README.md +++ b/1987/biggar/README.md @@ -3,6 +3,7 @@ Mark Biggar\ US + ## To build: ```sh @@ -16,12 +17,14 @@ make all some_command | ./biggar | od -c ``` -## Try: + +### Try: ```sh ./biggar < biggar.c | od -c ``` + ## Judges' remarks: By changing the compile line you can make this program do anything you @@ -50,6 +53,7 @@ an infinite loop by this entry. No remarks were provided by the author. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1987/heckbert/README.md b/1987/heckbert/README.md index 7b0208709..f96fa2a9c 100644 --- a/1987/heckbert/README.md +++ b/1987/heckbert/README.md @@ -2,6 +2,7 @@ Paul Heckbert\ + ## To build: ```sh @@ -11,6 +12,7 @@ make all On System V systems, we had to compile with `-Dindex=strchr`. To compile on a 16 bit machine, change 300000 to 30000. + ## To use: ```sh @@ -19,7 +21,8 @@ To compile on a 16 bit machine, change 300000 to 30000. where col is the number of columns to fold at and file is the file to fold. -## Try: + +### Try: ```sh ./heckbert 40 < heckbert.c > ph.c; make ph @@ -33,6 +36,7 @@ Ask yourself what happens to `foo.md` if you try: ./ph 40 < README.md > foo.md ``` + ## Judges' remarks: Folding at the wrong length may be equivalent to a "Spindle or Mutilate" operation. For example: @@ -50,10 +54,12 @@ very long lines which the BSD fold(1)\ was unable to process. This program has\ been added to the contest tool chest. + ## Author's remarks: No remarks were provided by the author. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1987/hines/README.md b/1987/hines/README.md index b7eebd829..fd1ed5530 100644 --- a/1987/hines/README.md +++ b/1987/hines/README.md @@ -3,19 +3,22 @@ Spencer Hines\ US + ## To build: ```sh make all ``` + ## To use: ```sh ./hines file.c ``` -## Try: + +### Try: ```sh ./hines hines.c @@ -32,6 +35,7 @@ make alt Use `hines.alt` as you would `hines` above. + ## Judges' remarks: This program was designed to maximize the bother function for @@ -48,6 +52,7 @@ See the Communications of the ACM, March 1987, Page 195-196. No remarks were provided by the author. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1987/korn/README.md b/1987/korn/README.md index 82be51929..76c797ee8 100644 --- a/1987/korn/README.md +++ b/1987/korn/README.md @@ -3,18 +3,21 @@ David Korn\ US + ## To build: ```sh make all ``` + ## To use: ```sh ./korn ``` + ## Judges' remarks: The Judges believe that this is the best one line entry ever received. @@ -61,6 +64,7 @@ improved version of the [/bin/sh](https://en.wikipedia.org/wiki/Bourne_shell). The source for [v7](https://en.wikipedia.org/wiki/Version_7_Unix)'s /bin/sh greatly inspired this contest. + ## Author's remarks: No remarks were provided by the author. diff --git a/1987/lievaart/README.md b/1987/lievaart/README.md index ff73d0b83..1aae535c3 100644 --- a/1987/lievaart/README.md +++ b/1987/lievaart/README.md @@ -3,6 +3,7 @@ Roemer B. Lievaart\ Netherlands + ## To build: ```sh @@ -12,6 +13,7 @@ make all There is [Alternate code](#alternate-code) available for if you have an old enough compiler. + ## To use: ```sh @@ -19,7 +21,8 @@ enough compiler. # enter a level and start playing as described below ``` -## Try: + +### Try: To see what it would have looked like without the size restrictions: @@ -69,6 +72,7 @@ logic and displays the board after each move! See above for how to use this. No remarks were provided by the author. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1987/wall/README.md b/1987/wall/README.md index d97e9804f..9be5be4b9 100644 --- a/1987/wall/README.md +++ b/1987/wall/README.md @@ -3,6 +3,7 @@ Larry Wall\ US + ## To build: ```sh @@ -21,7 +22,7 @@ make all ``` -## Try: +### Try: ```sh ./wall | bc | ./wall @@ -58,7 +59,6 @@ quit # for the cat version ## Judges' remarks: - What we found amazing was how the flow of control was transferred between subroutines. Careful inspection will show that the array of pointers to functions named `vi` refers to functions which seem to not be directly called. @@ -73,6 +73,7 @@ Some compilers complained about this file, so we changed: `=++I` to `= ++I`. No remarks were provided by the author. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1987/westley/README.md b/1987/westley/README.md index d0ee03792..d0d2aa76b 100644 --- a/1987/westley/README.md +++ b/1987/westley/README.md @@ -4,12 +4,14 @@ Brian Westley (aka Merlyn Leroy on usenet)\ US\ + ## To build: ```sh make all ``` + ## To use: ```sh @@ -36,6 +38,7 @@ If it fails to compile, bug your OS/compiler vendor. Line by line symmetry performed better than any C beautifier. Think of if it as a C ink blot. :-) + ## Author's remarks: No remarks were provided by the author. diff --git a/1988/applin/README.md b/1988/applin/README.md index 302e5d780..95b12b817 100644 --- a/1988/applin/README.md +++ b/1988/applin/README.md @@ -4,6 +4,7 @@ Jack Applin\ US\ + ## To build: ```sh @@ -15,7 +16,8 @@ the source of the alt code), of [applin.c](applin.c), can be found in [applin.alt.c](applin.alt.c). Your machine may have an easier time with this program. See the [Alternate code](#alternate-code) section below for details. -## Try: + +### Try: ```sh ./applin diff --git a/1988/dale/README.md b/1988/dale/README.md index d6bc774e8..4400c9585 100644 --- a/1988/dale/README.md +++ b/1988/dale/README.md @@ -3,6 +3,7 @@ Paul Dale\ Australia + ## To build: ```sh @@ -10,7 +11,7 @@ make all ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -21,7 +22,7 @@ STATUS: INABIAF - please **DO NOT** fix For more detailed information see [1988 dale in bugs.md](/bugs.md#1988-dale). -## Try: +### Try: ```sh ./dale hello world @@ -51,7 +52,7 @@ Use `dale.alt` as you would `dale` above. To understand the differences in more detail, see [thanks-for-fixes.md](/thanks-for-fixes.md). -## Judges' remarks +## Judges' remarks: This entry has a very twisted flow of control via recursion, iteration and multi-processing. Try to understand what is being done with the @@ -59,6 +60,7 @@ system calls. NOTE: This program assumes the ASCII character set is being used. + ## Author's remarks: No remarks were provided by the author. diff --git a/1988/isaak/README.md b/1988/isaak/README.md index 0e8e33f32..fa6fee245 100644 --- a/1988/isaak/README.md +++ b/1988/isaak/README.md @@ -3,6 +3,7 @@ Mark Isaak\ US + ## To build: ```sh @@ -13,6 +14,7 @@ There is an alternate version, the original, that can't be compiled in modern systems but can be if you have an old enough compiler. See [Alternate code](#alternate-code) below. + ## To use: ```sh @@ -45,6 +47,7 @@ make alt Use `isaak.alt` as you would `isaak` above. + ## Judges' remarks: The program relies heavily on ASCII. Don't even think of running it on @@ -75,6 +78,7 @@ Since this was fixed, this file is not strictly necessary. See the FYI: We are likely to be more strict about portability in the future. + ## Author's remarks: No remarks were provided by the author. diff --git a/1988/litmaath/README.md b/1988/litmaath/README.md index 934e66e29..6b9ed005e 100644 --- a/1988/litmaath/README.md +++ b/1988/litmaath/README.md @@ -3,12 +3,14 @@ Maarten Litmaath\ The Netherlands + ## To build: ```sh make ``` + ## To use: ```sh @@ -18,7 +20,8 @@ make There is an alternate version provided. See the [Alternate code](#alternate-code) section below. -## Try: + +### Try: ```sh ./litmaath eschew obfuscation @@ -82,6 +85,7 @@ fprintf(stderr, No remarks were provided by the author. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1988/phillipps/README.md b/1988/phillipps/README.md index 220a67f61..0d3abf543 100644 --- a/1988/phillipps/README.md +++ b/1988/phillipps/README.md @@ -3,6 +3,7 @@ Ian Phillipps\ UK + ## To build: ```sh @@ -20,6 +21,7 @@ and thus represents a new departure in text compression standards. The judges thought that this program looked like what you would get by pounding on the keys of an old typewriter at random. + ## Author's remarks: No remarks were provided by the author. diff --git a/1988/reddy/README.md b/1988/reddy/README.md index 95cef11c3..e0dd2c385 100644 --- a/1988/reddy/README.md +++ b/1988/reddy/README.md @@ -6,12 +6,12 @@ US ## To build: - ```sh make all ``` -## Try: + +### Try: ```sh ./reddy @@ -27,12 +27,14 @@ char *(*(*(*(*(*fun[32])))))()); ? What can you do about it? + ## Judges' remarks: This is a somewhat restricted version of a useful program that has been posted to Usenet. What is unusual is what it is able to do so much in such little space. + ## Author's remarks: No remarks were provided by the author. diff --git a/1988/robison/README.md b/1988/robison/README.md index 6fb9cc94f..3297928bf 100644 --- a/1988/robison/README.md +++ b/1988/robison/README.md @@ -3,13 +3,15 @@ Arch D. Robison\ US + ## To build: ```sh make all ``` -## Try: + +### Try: ```sh ./robison 80 10 @@ -23,6 +25,7 @@ The first and second parameters are optional. You might also try: ./robison 80 -246 ``` + ## Judges' remarks: The following might make an interesting benchmark: @@ -48,6 +51,7 @@ new paradigm.) Note that the lack of both the controversial `goto` and assignment statements makes the meaning crystal clear. The current\ ANSI committee should look into this practical simplification of C. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1988/spinellis/README.md b/1988/spinellis/README.md index c289e83b7..312bd57f0 100644 --- a/1988/spinellis/README.md +++ b/1988/spinellis/README.md @@ -5,13 +5,15 @@ GR\ \ Mastodon: + ## To build: ```sh make all ``` -## Try: + +### Try: ```sh rm -f spinellis ; cc spinellis.c -o spinellis < input.txt && ./spinellis @@ -37,6 +39,7 @@ and try: cc spinellis.alt.c -o spinellis.alt < input2.txt && ./spinellis.alt ``` + ## Judges' remarks: We enjoyed this entry this year; however in the future programs must be able to @@ -51,6 +54,7 @@ to perform. A trivial example is given in the `how to compile' section but the possibilities are clearly limited only by your imagination and programming skills. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1988/westley/README.md b/1988/westley/README.md index 356864ed6..aed701d33 100644 --- a/1988/westley/README.md +++ b/1988/westley/README.md @@ -4,6 +4,7 @@ Merlyn LeRoy (Brian Westley)\ US + ## To build: ```sh @@ -14,7 +15,7 @@ NOTE: this version is a fixed version for modern C compilers. See the [Alternate code](#alternate-code) section below for how to use the original. -## Try: +### Try: ```sh ./westley @@ -28,6 +29,7 @@ Also try: to show the code with followed by the result so you can truly see the magic. + ## Judges' remarks: Your compiler must parse @@ -72,7 +74,6 @@ Does it show the same output as `westley`? No remarks were provided by the author. - ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1989/fubar/README.md b/1989/fubar/README.md index 309573582..20378dd08 100644 --- a/1989/fubar/README.md +++ b/1989/fubar/README.md @@ -3,6 +3,7 @@ Jay Vosburgh\ US + ## To build: ```sh @@ -10,7 +11,7 @@ make all ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -27,7 +28,8 @@ For more detailed information see [1989 fubar in bugs.md](/bugs.md#1989-fubar). ./fubar ``` -## Try: + +### Try: ```sh ./fubar 2 @@ -45,6 +47,7 @@ Do you know why? NOTE: the file `ouroboros.c` is created by the program itself so this is why it is not in the repository. + ## Author's remarks: In a nutshell, this is probably the slowest and most @@ -60,6 +63,7 @@ works by successively modifying #define lines each pass through. Both `indent` and `cb` will damage the program, `indent` much more so. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1989/jar.1/README.md b/1989/jar.1/README.md index 7eeadd0f5..0100d5a82 100644 --- a/1989/jar.1/README.md +++ b/1989/jar.1/README.md @@ -7,6 +7,7 @@ Otakaari 1\ 02150 Espoo\ Finland + ## To build: NOTE: this will run the program itself. @@ -18,6 +19,7 @@ make clobber all There is an alternate version with a slight difference that you may wish to try. See [Alternate code](#alternate-code) below. + ## To use: NOTE: this will run the program itself: @@ -91,12 +93,14 @@ more apparent, as was the case when using dumb CRT terminals (some do dumb that they couldn't even process simple ANSI escape sequences) were more common. + ## Author's remarks: This program is (supposedly) the smallest C program able to print "Hello world.". The compilation itself produces the desired printout and the program need not be actually run. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1989/jar.2/README.md b/1989/jar.2/README.md index c30c6fdcc..7deff80e7 100644 --- a/1989/jar.2/README.md +++ b/1989/jar.2/README.md @@ -7,6 +7,7 @@ Otakaari 1\ 02150 Espoo\ Finland + ## To build: ```sh @@ -27,7 +28,8 @@ make all NOTE: this entry will likely segfault on invalid input. -## Try: + +### Try: ```sh ./try.sh @@ -114,6 +116,7 @@ made using string representations of the lists. These operations must count parentheses and skip whitespace. This leads to extremely poor performance! + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1989/ovdluhe/README.md b/1989/ovdluhe/README.md index d4bca6376..9f43d0650 100644 --- a/1989/ovdluhe/README.md +++ b/1989/ovdluhe/README.md @@ -6,6 +6,7 @@ ETH - Zentrum\ 8092 Zuerich\ Switzerland + ## To build: ```sh @@ -14,6 +15,7 @@ make all To get this to compile with a modern CPP, we had to replace `#D` with `#define`. + ## To use: Run the program this way: @@ -25,7 +27,8 @@ Run the program this way: The program stops when it reaches the end of the template buffer\ by chance or is killed. -## Try: + +### Try: ```sh ./ovdluhe < ./ovdluhe.c @@ -66,7 +69,6 @@ such as mailboxes, man pages and usenet articles are especially recommended. You will get different output each time you run it. - ## Author's remarks: This program implements an "Eddington ape" - it generates @@ -86,6 +88,7 @@ sentences can be dramatically random. You might want to vary the definition of P between 2 and 10 and observe the result. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1989/paul/README.md b/1989/paul/README.md index 26fc2f431..c2cbf011a 100644 --- a/1989/paul/README.md +++ b/1989/paul/README.md @@ -3,6 +3,7 @@ Paul E. Black\ US + ## To build: ```sh @@ -12,7 +13,8 @@ make all There is an alternate version with a trace routine that the author had commented out. See [alternate code](#alternate-code) below for more details. -## Try: + +### Try: ```sh ./paul @@ -56,6 +58,7 @@ and joining lines 12 and 13 together without a space. However as this is no longer a problem the trailing `\` has been restored in all versions, both the original and the fixed for modern systems version. + ## Author's remarks: This programs computes and prints Fibonacci numbers by @@ -140,6 +143,7 @@ the program. Besides it is fun to watch the tape zooming back and forth as the program runs. A much better debugger or trace could easily be added. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1989/robison/README.md b/1989/robison/README.md index c4f734ea6..ba3a627a6 100644 --- a/1989/robison/README.md +++ b/1989/robison/README.md @@ -3,6 +3,7 @@ Arch D. Robison\ US + ## To build: ```sh @@ -10,7 +11,7 @@ make all ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -28,7 +29,8 @@ For more detailed information see [1989 robison in bugs.md](/bugs.md#1989-robiso # enter valid expressions ``` -## Try: + +### Try: ```sh ./robison @@ -50,6 +52,7 @@ echo 100 / 100 | ./robison # <-- what happens here ? This program will very likely crash or break into tiny bits :-) if you feed it numbers with non-binary digits. + ## Judges' remarks: Sites with punch card facilities will be happy to note that @@ -61,6 +64,7 @@ constructs that the C language supports. For an interesting document on APL, see . + ## Author's remarks: This program is a handy picoAPL interpreter written in `C--`. It @@ -95,6 +99,7 @@ To obtain a `C--` reference, simply rip out the irrelevant pages from your K&R C manual. To obtain a `C--` compiler, simply rip out the irrelevant bytes from your `cc` compiler. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1989/roemer/README.md b/1989/roemer/README.md index dd7ce0e51..665ff468c 100644 --- a/1989/roemer/README.md +++ b/1989/roemer/README.md @@ -3,23 +3,27 @@ Lievaart, Roemer B.\ Netherlands + ## To build: ```sh make all ``` -## Try: + +### Try: ```sh ./roemer ``` + ## Judges' remarks: Do you know what this program does? If you do, look again, there is more here than meets the PI. + ## Author's remarks: Passes lint, but not with the strictest options, for it contains some @@ -30,6 +34,7 @@ independent. You are very much invited to pass this program through a C-beautifier (first strip newlines and tabs, if your `cb` can't do that). + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1989/tromp/README.md b/1989/tromp/README.md index b750569dd..b5201c00e 100644 --- a/1989/tromp/README.md +++ b/1989/tromp/README.md @@ -3,19 +3,22 @@ John Tromp\ Netherlands + ## To build: ```sh make all ``` + ## To use: ```sh ./tromp [drops_per_sec [cmd_string]] ``` -## Try: + +### Try: ```sh ./tromp 5 @@ -70,6 +73,7 @@ benefits of the alt version, has not been done. The original unmodified alternate code, which will no longer work right if it even compiles, is provided later in the author's remarks. + ## Judges' remarks: This is a character terminal version of the `TETRIS` game. @@ -163,6 +167,7 @@ can only by stopped by 'q' or by the `kill -9' command. NOTE: the alternate version was fixed for modern systems in 2023. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1989/vanb/README.md b/1989/vanb/README.md index 84643c984..830d665fe 100644 --- a/1989/vanb/README.md +++ b/1989/vanb/README.md @@ -14,13 +14,15 @@ US make all ``` -## Try: + +### Try: ```sh ./vanb the rug gary lent ./vanb unix is better than os/2 ``` + ## Judges' remarks: This program computes all proper subsets of the set of @@ -28,7 +30,6 @@ arguments passed to it. Each subset is printed with one element on each line, followed by a line of ten dashes. - ## Author's remarks: The program has the following charming and possibly @@ -43,6 +44,7 @@ non-portable features: * It uses the fact that if the high bit is set in a character variable, the value is negative. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1989/westley/README.md b/1989/westley/README.md index 53cc08152..19bb8eb03 100644 --- a/1989/westley/README.md +++ b/1989/westley/README.md @@ -4,6 +4,7 @@ Merlyn LeRoy (Brian Westley)\ US\ + ## To build: ```sh @@ -11,7 +12,7 @@ make all ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -22,7 +23,7 @@ STATUS: known bug - please help us fix For more detailed information see [1989 westley in bugs.md](/bugs.md#1989-westley). -## Try: +### Try: Try compiling and running the 4 resulting programs like: @@ -55,7 +56,6 @@ Finally try: ## Judges' remarks: - There is a secret way to get ONE of the versions to print out "`Hello, world!\n`". Can you find how to do it? @@ -176,6 +176,7 @@ helped here. It barely fits on an 80x24 screen. Squint. Note that the code must start with a blank line, or the reversed version will lack a terminating newline. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1990/baruch/README.md b/1990/baruch/README.md index 88335fb89..52a61e895 100644 --- a/1990/baruch/README.md +++ b/1990/baruch/README.md @@ -6,6 +6,7 @@ Israel Doron Osovlanski\ Israel + ## To build: ```sh @@ -14,6 +15,7 @@ make all There is [alternate code](#alternate-code) for those using Turbo-C or MSC. + ## To use: ```sh @@ -21,7 +23,8 @@ echo 4 | ./baruch echo 7 | ./baruch ``` -## Try: + +### Try: ```sh echo 2 | ./baruch @@ -93,6 +96,7 @@ In order to compile the program under Turbo-C or MSC, `int ` should be inserted at the beginning of the program. For better looking results it is recommended to replace the `" #Q"` string with `" \261\2"`. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1990/cmills/README.md b/1990/cmills/README.md index ad8a117c8..fe7fa5556 100644 --- a/1990/cmills/README.md +++ b/1990/cmills/README.md @@ -3,12 +3,14 @@ Chris Mills\ US + ## To build: ```sh make all ``` + ## To use: ```sh @@ -16,7 +18,7 @@ make all ``` -## Try: +### Try: ```sh ./cmills 5000 @@ -25,7 +27,6 @@ make all ## Judges' remarks: - The Makefile uses several `-D` defines. The following is is a list of the macros that may be changed: @@ -40,6 +41,7 @@ but do you know why? This is not so strange as it might seem if you look at [C's history](https://www.bell-labs.com/usr/dmr/www/chist.html). Example code where this occurs is in John Lions' Commentary on the Sixth Edition UNIX Operating System. + ## Author's remarks: This is a blackjack program. It does splits, doubling down, insurance, etc. @@ -53,6 +55,7 @@ the program, hit `EOF` or type `0` or a negative number for you wager. The way it deals with splits is particularly cool (IMHO). You can split many times, and it will show all hands as they are played. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1990/dds/README.md b/1990/dds/README.md index 1a2b37d8e..7b10e3985 100644 --- a/1990/dds/README.md +++ b/1990/dds/README.md @@ -5,6 +5,7 @@ Greece\ \ Mastodon: + ## To build: ```sh @@ -18,7 +19,8 @@ make all ./dds ``` -## Try: + +### Try: Give the following lines as input: @@ -31,6 +33,7 @@ NOTE: this entry is probably one of the only times CAPS LOCK might be worth having (though still not useful enough to enable :-) ) as all input has to be UPPER CASE. + ## Judges' remarks: Be sure not to run out of fuel! @@ -123,6 +126,7 @@ lines. In its present 1536 character form the program is reasonably portable (it may fail to run in a tagged object architecture) and nicely formatted (it fits in an `80*25` screen). + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1990/dg/README.md b/1990/dg/README.md index 4752827ec..3431cc318 100644 --- a/1990/dg/README.md +++ b/1990/dg/README.md @@ -6,6 +6,7 @@ anonymous organization\ Newton, MA 02159\ US + ## To build: ```sh @@ -19,12 +20,14 @@ make all echo foo bar | ./dg ``` -## Try: + +### Try: ```sh echo "to C or not to C" | ./dg ``` + ## Judges' remarks: Some C preprocessors got confused about single quotes in certain cases. @@ -69,6 +72,7 @@ with: If `index(3)` says the char is in the alphabet, then XOR the offset with `16` to translate, and output, otherwise pass it unchanged. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1990/jaw/README.md b/1990/jaw/README.md index f92b2792b..3e8ff65a6 100644 --- a/1990/jaw/README.md +++ b/1990/jaw/README.md @@ -9,6 +9,7 @@ US Paul Eggert\ US + ## To build: ```sh @@ -16,7 +17,7 @@ make all ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -27,7 +28,7 @@ STATUS: known bug - please help us fix For more detailed information see [1990 jaw in bugs.md](/bugs.md#1990-jaw). -## Try: +### Try: To test the official C entry, one might try: @@ -45,8 +46,8 @@ Also try: ./try.sh ``` -## Judges' remarks: +## Judges' remarks: The program, in its base form, implements two useful utilities: @@ -233,6 +234,7 @@ To which we add: - June 1990: 'shark' wins the IOCCC, finally! :-) + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1990/pjr/README.md b/1990/pjr/README.md index 3a30a9fd7..05ca27a1f 100644 --- a/1990/pjr/README.md +++ b/1990/pjr/README.md @@ -8,18 +8,21 @@ Farnborough\ Hants GU14 7PL\ England, U.K. + ## To build: ```sh make all ``` + ## To use: ```sh ./pjr ``` + ## Judges' remarks: This program prints out a string. Can you figure out how @@ -72,6 +75,7 @@ Rot13: in the original program! I leave it as an intellectual exercise to the reader to find out what it is. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1990/stig/README.md b/1990/stig/README.md index 37470b672..7d0c0817b 100644 --- a/1990/stig/README.md +++ b/1990/stig/README.md @@ -5,12 +5,14 @@ Norwegian Institute of Technology\ N-7034 Trondheim-NTH\ Norway + ## To build: ```sh make all ``` + ## To use: ```sh @@ -23,7 +25,8 @@ NOTE: that's not a typo or mistake but one can also do: ./o ``` -## Judges' remarks + +## Judges' remarks: We changed the alias that the author's suggested alias from a C-shell alias to a zsh alias. @@ -34,6 +37,7 @@ WARNING: This program's `how to compile` is too specific to a particular shell. The obfuscation of this program is more related to shell obfuscation than C obfuscation. This type of entry will not be permitted in future contests. + ## Author's remarks: If you like shell programming you may also admire my creative quoting. (I use @@ -51,6 +55,7 @@ whether your compiler supports nested comments. I've stolen the `"/*/*/0*/**/1"` from somewhere so don't give me any points for it. Of course neither ANSI nor K&R support nested comments when properly implemented, but what the heck. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1990/tbr/README.md b/1990/tbr/README.md index 4e3f21b11..d8dd7ff3b 100644 --- a/1990/tbr/README.md +++ b/1990/tbr/README.md @@ -13,6 +13,7 @@ US make all ``` + ## To use: ```sh @@ -27,7 +28,7 @@ or ctrl-c (or kill it from another terminal :-) ). But why does it not work with just `exit` or `logout`? Hint: see the authors' remarks. -## Try: +### Try: ```sh ./tbr @@ -47,6 +48,7 @@ What happens if you try using `cd -` to return to previous directory? What about The authors include a section called [BUGS](#bugs) that, because they were documented, are not considered bugs as such in the context of the contest. + ## Judges' remarks: This program touches on a well known Unix utility, the 6th edition Bourne Shell diff --git a/1990/theorem/README.md b/1990/theorem/README.md index 6186aac54..ae785f694 100644 --- a/1990/theorem/README.md +++ b/1990/theorem/README.md @@ -14,7 +14,7 @@ make all ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -41,7 +41,8 @@ h - step size y1 - initial value (y(x1) == y1) ``` -## Try: + +### Try: ```sh ./theorem y 0 1 0.1 1 diff --git a/1990/westley/README.md b/1990/westley/README.md index fa3733e6b..e1ea2571a 100644 --- a/1990/westley/README.md +++ b/1990/westley/README.md @@ -23,7 +23,8 @@ make all The number should be greater than 0. -## Try: + +### Try: ```sh ./westley 1 diff --git a/1991/ant/README.md b/1991/ant/README.md index 85d3cd4fa..d29ef2c03 100644 --- a/1991/ant/README.md +++ b/1991/ant/README.md @@ -6,12 +6,14 @@ Mortice Kern Systems Inc. #CL-23\ Waterloo, On Waterloo, On\ Canada, N2J 2W9 Canada, N2L 6G9 + ## To build: ```sh make all ``` + ## To use: ```sh @@ -21,13 +23,15 @@ make all NOTE: the file must already exist and not specifying any arg will make the program exit without doing anything. -## Try: + +### Try: ```sh cp README.md hill ./ant hill ``` + ## Judges' remarks: The author was kind enough to supply a list of references below, @@ -44,6 +48,7 @@ NOTE: to enter form feed you should be able to hit `ctrl-L`. This will allow you to exit insert mode rather than ESC like in normal vi(m). See the author's commands section for other commands. + ## Author's remarks: Ant's Editor vIOCCC91 @@ -123,6 +128,7 @@ screen with long lines. Paging up and down should work correctly, however. [net90] "Editor 101/102" articles from comp.editors + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1991/brnstnd/README.md b/1991/brnstnd/README.md index 88a8b552a..f55f31aab 100644 --- a/1991/brnstnd/README.md +++ b/1991/brnstnd/README.md @@ -11,7 +11,7 @@ make all ``` -## Try: +### Try: ```sh ./brnstnd < sorta.i2+2 diff --git a/1991/buzzard/README.md b/1991/buzzard/README.md index b005558d1..7026a4546 100644 --- a/1991/buzzard/README.md +++ b/1991/buzzard/README.md @@ -6,24 +6,28 @@ University of Maryland\ Hyattsville MD 20782\ US + ## To build: ```sh make all ``` + ## To use: ```sh ./buzzard ``` + ## Judges' remarks: You will be A-mazed. You are invited to try to cheat, ... if you can figure out how! :-) + ## Author's remarks: ### How to play @@ -94,6 +98,7 @@ Rot13 to read: Gur cebtenz nffhzrf gung gnof ner frg gb 8 punenpgref. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1991/cdupont/README.md b/1991/cdupont/README.md index 30b5862a9..98a638bc2 100644 --- a/1991/cdupont/README.md +++ b/1991/cdupont/README.md @@ -7,18 +7,21 @@ Laboratoire d'Informatique Parallele\ 69009 Lyon\ France + ## To build: ```sh make all ``` + ## To use: ```sh ./cdupont ``` + ## Judges' remarks: Why is the following label necessary? @@ -34,6 +37,7 @@ NOTE: One should remove the final trailing newline to obtain the original source file. This step is not needed to compile this entry. + ## Author's remarks: Spoiler, rot13 to read: @@ -50,6 +54,7 @@ Spoiler, rot13 to read: Guvf jnl, nal zrffntr pna or zvkrq vagb n pbqr, fvapr gur xrlf nyybj lbh gb cynpr gur zrnavatshy yrggref jurerire lbh jnag. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1991/davidguy/README.md b/1991/davidguy/README.md index 55857799c..f30509855 100644 --- a/1991/davidguy/README.md +++ b/1991/davidguy/README.md @@ -20,6 +20,7 @@ US make all ``` + ## To use: ```sh @@ -28,7 +29,8 @@ make all where `ip_address` in an IP address of an X server. -## Try: + +### Try: ```sh ./davidguy 127.0.0.1:0.0 @@ -45,8 +47,8 @@ cp -f davidguy guydavid Can you determine why this makes a difference? -## Judges' remarks: +## Judges' remarks: We permitted this type of entry to win because: @@ -129,6 +131,7 @@ result is that the time to transfer the bits to the X server, and for the X server to draw them on the screen, dominates the time to compute the next generation. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1991/dds/README.md b/1991/dds/README.md index 78c7623aa..aff58d6a1 100644 --- a/1991/dds/README.md +++ b/1991/dds/README.md @@ -13,7 +13,6 @@ make all ``` - ## To use: ```sh @@ -21,7 +20,8 @@ make all ./a.out 2>/dev/null ``` -## Try: + +### Try: The author suggests trying: diff --git a/1991/fine/README.md b/1991/fine/README.md index 6b9b4a014..5c1135464 100644 --- a/1991/fine/README.md +++ b/1991/fine/README.md @@ -4,19 +4,22 @@ Thomas A. Fine\ US\ [@thomasafine@social.linux.pizza](https://social.linux.pizza/@thomasafine) + ## To build: ```sh make all ``` + ## To use: ```sh echo text | ./fine ``` -## Try: + +### Try: ```sh ./try.sh @@ -47,6 +50,7 @@ How does this program work? Which 3 bytes of C code can be changed into 2 bytes, allowing the program to still work, but also stripping the high bit off some input? + ## Author's remarks: The author wishes to thank J Greely for the last 6 bytes. @@ -90,7 +94,6 @@ data, the size can be reduced by one byte. These are left as exercises for the student. - ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1991/rince/README.md b/1991/rince/README.md index b341f6bca..bba8e3a0c 100644 --- a/1991/rince/README.md +++ b/1991/rince/README.md @@ -8,22 +8,26 @@ Sandy Beds\ SG19 2HA\ England + ## To build: ```sh make all ``` + ## To use: ```sh ./rince ``` + ## Judges' remarks: This entry has been updated to allow most ANSI C compilers. + ## Author's remarks: This program is a simple puzzle type game. (I'll leave you to play @@ -68,6 +72,7 @@ enjoyment high.\ znc). Gb haybpx n qbbe fvzcyl chfu n xrl vagb gur pbeerfcbaqvat qbbe. Gnxr pner gung vg'f snpvat va gur pbeerpg qverpgvba. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1991/westley/README.md b/1991/westley/README.md index 186ca1d1f..dca669893 100644 --- a/1991/westley/README.md +++ b/1991/westley/README.md @@ -15,7 +15,7 @@ make all ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -50,7 +50,8 @@ make nextmove ./nextmove move_location | tee nextmove.c ``` -## Try: + +### Try: We have provided the shell script, [ttt](ttt.sh), to make it easier to play the game: diff --git a/1992/adrian/README.md b/1992/adrian/README.md index 50929f346..1e123672a 100644 --- a/1992/adrian/README.md +++ b/1992/adrian/README.md @@ -11,7 +11,7 @@ make all ``` -## Try: +### Try: ```sh ./adrian adrian.grep.try < README.md @@ -27,6 +27,7 @@ NOTE: if you do not specify an arg to the program it will segfault. ## Judges' remarks: + \ Once you get past the obfuscation, you have an opportunity to learn about regular expressions and state machines. diff --git a/1992/albert/README.md b/1992/albert/README.md index c435e3d33..8a3ac1ca0 100644 --- a/1992/albert/README.md +++ b/1992/albert/README.md @@ -6,19 +6,22 @@ Oranjestraat 8\ 3511 RA UTRECHT\ The Netherlands + ## To build: ```sh make all ``` + ## To use: ```sh ./albert number ``` -## Try: + +### Try: ```sh ./albert 1234567890123456789 @@ -58,12 +61,15 @@ make alt Use `albert.alt` as you would `albert` above. + ## Judges' remarks: + \ We were impressed with the speed at which it was able to factor arbitrarily large numbers consisting of factors that fit into a long. + ## Author's remarks: The Obfuscated version of the Horst algorithm. @@ -133,6 +139,7 @@ modified form. 4. The Conversion is to be found in Knuth, not so the Observation. The Observation: "if it ends in a zero, it is divisible by ten". + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1992/ant/README.md b/1992/ant/README.md index f636d9a89..e3e6415ab 100644 --- a/1992/ant/README.md +++ b/1992/ant/README.md @@ -7,12 +7,14 @@ Waterloo, Ontario\ N2J 3G4\ Canada + ## To build: ```sh make all ``` + ## To use: ```sh @@ -22,7 +24,7 @@ make all where `Makefile` is a Makefile to use. -## Try: +### Try: ```sh ./ant ant.test.mk @@ -39,7 +41,6 @@ make am ## Judges' remarks: - Like much of POSIX, obfuscation has its place. Your task is to figure out where. @@ -52,6 +53,7 @@ P1003 subcommittee. See the file [ant.README](ant.README). + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1992/buzzard.1/README.md b/1992/buzzard.1/README.md index 5f8ae55d2..009d8bb29 100644 --- a/1992/buzzard.1/README.md +++ b/1992/buzzard.1/README.md @@ -20,7 +20,8 @@ make all NOTE: this program will crash without two args. -## Try: + +### Try: ```sh ./buzzard.1 0 10 @@ -28,6 +29,7 @@ NOTE: this program will crash without two args. ./buzzard.1 1 521 ``` + ## Judges' remarks: To see good C Preprocessor buzzard.1, try: @@ -39,6 +41,7 @@ cat babble.cppcb Notice how many statements it takes to do anything useful? + ## Author's remarks: What you shouldn't think about `buzzard.1`: @@ -239,6 +242,7 @@ my attention. `buzzard.1` was originally named 'cb', for obvious reasons, and is dedicated to the memory of Charles Barrett. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1992/buzzard.2/README.md b/1992/buzzard.2/README.md index 22becedff..36db3f81d 100644 --- a/1992/buzzard.2/README.md +++ b/1992/buzzard.2/README.md @@ -6,12 +6,14 @@ Software Construction Company\ College Station, TX 77840\ US + ## To build: ```sh make all ``` + ## To use: First: @@ -61,10 +63,12 @@ make alt Use `buzzard.2.alt` as you would `buzzard.2` above. + ## Judges' remarks: Have fun! + ## Author's remarks: ### What it does @@ -250,6 +254,7 @@ C source. Software Construction Company gets credit for rekindling my interest in FORTH and thus indirectly inspiring me to write this program. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1992/gson/README.md b/1992/gson/README.md index 571a9ad66..ee2382b7a 100644 --- a/1992/gson/README.md +++ b/1992/gson/README.md @@ -18,7 +18,7 @@ make all ``` -## Try: +### Try: Determine where your system dictionary is located. You may find it located in one of the following places: @@ -255,7 +255,6 @@ of the word matched by that invocation, and copying the characters of the word directly from standard input to standard output. - ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1992/imc/README.md b/1992/imc/README.md index cdf2460b8..00f8ed764 100644 --- a/1992/imc/README.md +++ b/1992/imc/README.md @@ -8,12 +8,14 @@ Oxford\ OX1 4AW\ England + ## To build: ```sh make all ``` + ## To use: ```sh @@ -23,6 +25,7 @@ make all ./imc\ ``` + ## Judges' remarks: The program is more interesting to run on workstations that can make use of a @@ -35,6 +38,7 @@ NOTE: The original winning source assumed that exit() returned a value which cau problems for some systems where exit() returns a void. The file [imc.c](imc.c) has been modified to avoid this problem. + ## Author's remarks: ### Portability @@ -164,6 +168,7 @@ Here are a couple of good pictures to draw: ./imc -s512,512 -j-.523,-.535 > screen2.ras ``` + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1992/kivinen/README.md b/1992/kivinen/README.md index a5f7eb64b..8fed0ba1c 100644 --- a/1992/kivinen/README.md +++ b/1992/kivinen/README.md @@ -21,7 +21,7 @@ install [XQuartz](https://www.xquartz.org) in order to compile and run this entry. -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -32,8 +32,7 @@ STATUS: known bug - please help us fix For more detailed information see [1992 kivinen in bugs.md](/bugs.md#1992-kivinen). -## Try: - +### Try: ```sh ./kivinen @@ -51,6 +50,7 @@ In modern systems a known issue is that when you start the game everything starts to move to the right of the game window but if you click on the window it moves back to where it should be. + ## Judges' remarks: The type of entertainment depends on number of arguments diff --git a/1992/lush/README.md b/1992/lush/README.md index c810dbb0d..30f362ea6 100644 --- a/1992/lush/README.md +++ b/1992/lush/README.md @@ -11,7 +11,7 @@ make all ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: diff --git a/1992/marangon/README.md b/1992/marangon/README.md index e7f98ba82..5be108fbe 100644 --- a/1992/marangon/README.md +++ b/1992/marangon/README.md @@ -6,18 +6,21 @@ Via Pausula, 72\ 62014 Corridonia (MC)\ Italy + ## To build: ```sh make all ``` + ## To use: ```sh ./marangon ``` + ## Judges' remarks: The object is to refill the table with 5's, by incrementing or decrementing @@ -33,12 +36,14 @@ directory, assumed that exit returns a value which cause problems for some systems where exit returns a void. The file [marangon.c](marangon.c) avoids this problem. + ## Author's remarks: It starts off by creating a table with number 5 in all places. The CPU melts the numbers and you must return them in original state. When you increase a number, all the other eight numbers next to it decrease and vice-versa. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1992/nathan/README.md b/1992/nathan/README.md index 02db484ee..3c0ca2ea1 100644 --- a/1992/nathan/README.md +++ b/1992/nathan/README.md @@ -7,19 +7,22 @@ Almondsbury\ Bristol\ UK BS12 4SQ + ## To build: ```sh make all ``` + ## To use: ```sh ./nathan ``` -## Try: + +### Try: ```sh ./nathan obfuscate < nathan.c > foobarf.c @@ -82,7 +85,8 @@ were/are. Certain US federal officials can get away with shipping arms to certain nations in apparent violation of US laws, but I personally can't re-distribute a program contest winner to the network! -## Author's remarks + +## Author's remarks: ### Program use @@ -129,6 +133,7 @@ serious overuse of , and ? :. These are really confusing when used together, nested or put in argument lists (is that a comma operator, or argument separator?) + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1992/vern/README.md b/1992/vern/README.md index 01088ce4f..60b7da92a 100644 --- a/1992/vern/README.md +++ b/1992/vern/README.md @@ -8,20 +8,22 @@ Lawrence Berkeley Laboratory\ 1 Cyclotron Rd.\ Berkeley, CA 94720 US + ## To build: ```sh make all ``` + ## To use: ```sh ./vern 3 # <-- default is 2 ``` -## Try: +### Try: You might start off by giving the following input: @@ -32,6 +34,7 @@ You might start off by giving the following input: 67 57 # (this may take a while) ``` + ## Judges' remarks: The judges assume no responsibility for the obfuscated opening @@ -52,6 +55,7 @@ NOTE: Move values must be restricted to the range 00 to 77. NOTE: Because some mailers have problems with the original winning source, a slightly modified version with shorter lines has been provided. + ## Author's remarks: This program plays chess. You play the white pieces and the program @@ -152,6 +156,7 @@ Sometimes the value produced will be 63 or 65 instead of 64 (but I've never observed any other values), so the result is then rounded to the nearest multiple of 4, and then the other constants are derived from it. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1992/westley/README.md b/1992/westley/README.md index 22d26d2a1..36ffaad83 100644 --- a/1992/westley/README.md +++ b/1992/westley/README.md @@ -31,7 +31,8 @@ Where lat and long correspond to your latitude and longitude. NOTE: you **MUST** have a terminal that wraps at 80 columns (!) in order for this to show correctly! -## Try: + +### Try: ```sh ./whereami 47 -122 (- means west of meridian) diff --git a/1993/ant/README.md b/1993/ant/README.md index 63230b299..12a2e4fd9 100644 --- a/1993/ant/README.md +++ b/1993/ant/README.md @@ -6,19 +6,22 @@ Unit 1, 14 Weber Street North\ Waterloo, Ontario, N2J 3G4\ Canada + ## To build: ```sh make all ``` + ## To use: ```sh ./ant 'ERE' [file ...] ``` -## Try: + +### Try: You may also want to try the author's test suite: @@ -26,6 +29,7 @@ You may also want to try the author's test suite: make -f ant.test.mk ``` + ## Judges' remarks: See the author's POSIX P1003.2-like documentation file ant.txt for more @@ -33,6 +37,7 @@ information. This program demonstrates that POSIX doesn't guarantee readability. :-) + ## Author's remarks: Some of the features of my entry are: @@ -46,6 +51,7 @@ Some of the features of my entry are: - Can be compiled with ANSI or K&R C. - Not a toy, but actually useful and usable on systems that use DOS. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1993/cmills/README.md b/1993/cmills/README.md index 5fbf683c4..08b6dd9a7 100644 --- a/1993/cmills/README.md +++ b/1993/cmills/README.md @@ -6,6 +6,7 @@ Pagine Corporation\ San Jose, CA 95131\ US + ## To build: ```sh @@ -17,6 +18,7 @@ compile. macOS users running Mountain Lion and later will need to download and install [XQuartz](https://www.xquartz.org) in order to compile and run this entry. + ## To use: ```sh @@ -29,6 +31,7 @@ where: `speed` is update speed from 1 to 9 (default is 9). + ## Judges' remarks: From the San Jose Mercury News (May 15, 1993 page 20A "West Hackers\ @@ -62,6 +65,7 @@ the program. This program makes your windows about as useful as their windows. :-) + ## Author's remarks: The program uses a single backing pixmap (which is the size of the @@ -73,6 +77,7 @@ a separate backing pixmap for each subwindow. The chance that a window breaks is based on it's kinetic energy, which in turn is based on it's area and speed. How silly! + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1993/dgibson/README.md b/1993/dgibson/README.md index b903adef0..6c9c9432a 100644 --- a/1993/dgibson/README.md +++ b/1993/dgibson/README.md @@ -7,12 +7,14 @@ Bergvliet\ 7945\ South Africa + ## To build: ```sh make all ``` + ## To use: ```sh @@ -23,13 +25,16 @@ where: \ `datafile` is the initial pattern (default: [dgibson.data1](dgibson.data1)) -## Try: + +### Try: ```sh ./dgibson.sh dgibson.data3 ``` + ## Judges' remarks: + \ We have provided the shell script [dgibson.sh](dgibson.sh) to make it easier to run this entry. Run this shell script several times to @@ -49,6 +54,7 @@ memory and lots of time! Good luck trying to use a debugger on this entry! Life is not always pretty. + ## Author's remarks: This program plays the [Game of @@ -75,6 +81,7 @@ grid expand to the code which calculates the fate of that cell. In addition, the resulting program is a single expression, which makes it necessary to recurse on main in two "directions" simultaneously. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1993/ejb/README.md b/1993/ejb/README.md index ba9d7c1d1..3703a0913 100644 --- a/1993/ejb/README.md +++ b/1993/ejb/README.md @@ -6,12 +6,14 @@ Engineering Research Associates\ Vienna, VA 22182-2235\ US + ## To build: ```sh make all ``` + ## To use: ```sh @@ -24,6 +26,7 @@ where: level a value from -128 to 127 ``` + ## Judges' remarks: A negative argument plays the patience puzzle. An argument @@ -37,7 +40,8 @@ the argument 127 to this program and want to see it finish! We note that this also works under macOS just fine. -## Author's remarks + +## Author's remarks: ### What this program does @@ -92,6 +96,7 @@ architecture it runs on have bytes that are at least eight bits long and pointers that are at least four bytes long. In addition, it requires an ANSI compiler since it uses "signed char" and ANSI-style function declarations. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1993/leo/README.md b/1993/leo/README.md index 3663c749f..7097cc29f 100644 --- a/1993/leo/README.md +++ b/1993/leo/README.md @@ -34,6 +34,7 @@ where: ## Judges' remarks: + \ By default, the number of colors is 6. You may specify a value of between 1 and 15 colors. See the author's notes diff --git a/1993/lmfjyh/README.md b/1993/lmfjyh/README.md index e7e8e3be5..bf6563cec 100644 --- a/1993/lmfjyh/README.md +++ b/1993/lmfjyh/README.md @@ -30,7 +30,7 @@ There is an alternate version which simply does what the program did with gcc < 2.3.3. -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -63,6 +63,7 @@ done with this bug; see the author's remarks for more details. ## Judges' remarks: + \ There's more than one way to get around disk quotas. :-) diff --git a/1993/plummer/README.md b/1993/plummer/README.md index 2ea47e606..cb7e38174 100644 --- a/1993/plummer/README.md +++ b/1993/plummer/README.md @@ -27,7 +27,7 @@ where: NOTE: an alternate version exists. See Alternate code section below. -## Try: +### Try: ```sh ./plummer 01234567890876543210 xxx @@ -64,6 +64,7 @@ make clobber CDEFINE="-DZ=50" alt For extra credit: What happens when 'number' contains non-numeric characters, and why? + ## Author's remarks: This program prints out all numbers up to a given number of digits diff --git a/1993/rince/README.md b/1993/rince/README.md index d2b5da181..5c526a479 100644 --- a/1993/rince/README.md +++ b/1993/rince/README.md @@ -13,6 +13,7 @@ make all NOTE: there is an alternate version of this program that allows one to slow down the game. See the Alternate code section below. + ## To use: ```sh diff --git a/1993/schnitzi/README.md b/1993/schnitzi/README.md index fc546cc23..082e89372 100644 --- a/1993/schnitzi/README.md +++ b/1993/schnitzi/README.md @@ -30,7 +30,7 @@ where This entry will segfault if the file cannot be opened. This is not a bug. -## Try: +### Try: ```sh ./schnitzi schnitzi.info diff --git a/1993/vanb/README.md b/1993/vanb/README.md index 5a68fecc6..8b2f48308 100644 --- a/1993/vanb/README.md +++ b/1993/vanb/README.md @@ -24,7 +24,7 @@ where `exp` is an octal expression. See below for how it can also have hexadecimal and decimal numbers. -## Try: +### Try: ```sh ./vanb '1+1' @@ -36,6 +36,7 @@ What happens if you use something other than valid digits? ## Judges' remarks: + \ The octal expression may contain: diff --git a/1994/dodsond1/README.md b/1994/dodsond1/README.md index fdde33dcb..6df5fa9f5 100644 --- a/1994/dodsond1/README.md +++ b/1994/dodsond1/README.md @@ -6,12 +6,14 @@ AG Communication Systems\ Phoenix, AZ 85023\ US + ## To build: ```sh make all ``` + ## To use: ```sh @@ -20,12 +22,14 @@ make all NOTE: At the prompt, try entering `E3`. + ## Judges' remarks: The program plays the game that the layout of the source implies. The source, on the other hand, implies a language along the lines of Lisp. :-) + ## Author's remarks: For each turn, the board is displayed and the player is prompted for @@ -35,6 +39,7 @@ The program uses a single function for 4 different purposes -- to determine if a valid move exists, to verify that a move is valid, to make a move, and to determine the value of a move. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1994/dodsond2/README.md b/1994/dodsond2/README.md index bd771f975..b6e0508bd 100644 --- a/1994/dodsond2/README.md +++ b/1994/dodsond2/README.md @@ -6,18 +6,21 @@ AG Communication Systems\ Phoenix, AZ 85023\ US + ## To build: ```sh make all ``` + ## To use: ```sh ./dodsond2 ``` + ## Judges' remarks: Each year people find new ways to squeeze more and more out of the @@ -52,6 +55,7 @@ this fun "_abuse of the rules_" style hack. It is worth noting that without this compression "_abuse of the rules_" style hack, the [dodsond2.c](dodsond2.c) is further obfuscated. + ## Author's remarks: Go searching for the Wumpus in the Caverns of Doom! But be careful... @@ -81,6 +85,7 @@ You can quit at any time by typing `q`. Typing `i` will tell you how many arrows you are carrying. `l` prints the description of the current room again. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1994/horton/README.md b/1994/horton/README.md index d4e7ba0ed..c302ec6f1 100644 --- a/1994/horton/README.md +++ b/1994/horton/README.md @@ -4,6 +4,7 @@ Mary Ann Horton\ US\ + ## To build: ```sh @@ -43,6 +44,7 @@ Try to figure out how this program prints, for a given slope, the right character. And for extra credit, try to figure out which character is at the bottom on this hint file. :-) + ## Author's remarks: Run it with any 4 numeric arguments, e.g. `./horton 3 2 1 0`. Play with the @@ -99,6 +101,7 @@ Sept/Oct 1992; Pages 28-31 , MMMM,MMMM"M"M"M,MM,M,", " ``` + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1994/imc/README.md b/1994/imc/README.md index c353ff83a..0d62f75c7 100644 --- a/1994/imc/README.md +++ b/1994/imc/README.md @@ -7,12 +7,14 @@ Bolton\ BL3 4LG\ England + ## To build: ```sh make all ``` + ## To use: ```sh @@ -21,7 +23,8 @@ make all where `[NUMBER]` is an optional number. Default is 5. -## Try: + +### Try: ```sh ./imc 3 @@ -32,6 +35,7 @@ where `[NUMBER]` is an optional number. Default is 5. ./imc 13 ``` + ## Judges' remarks: This entry's algorithm is as magic as its output! @@ -88,6 +92,7 @@ The square which is returned will (or should) be a permutation of the numbers 1 to `n*n` in which all rows and columns and the two diagonals add up to `n*(n*n+1)/2`. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1994/ldb/README.md b/1994/ldb/README.md index 3e27a0dcd..e9f4831a8 100644 --- a/1994/ldb/README.md +++ b/1994/ldb/README.md @@ -12,7 +12,7 @@ make all ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -32,7 +32,7 @@ some_command | ./ldb ``` -## Try: +### Try: ```sh ./ldb < /etc/passwd diff --git a/1994/schnitzi/README.md b/1994/schnitzi/README.md index 893aca139..98d0a8579 100644 --- a/1994/schnitzi/README.md +++ b/1994/schnitzi/README.md @@ -17,7 +17,7 @@ See below section bugs and (mis)features for details and the [alternate code](#alternate-code) section for how to use. -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -35,7 +35,7 @@ For more detailed information see [1994 schnitzi in bugs.md](/bugs.md#1994-schni ``` -## Try: +### Try: ```sh ./schnitzi < /etc/motd 2>/dev/null @@ -73,7 +73,6 @@ feeding the source code to it will not work right. ## Judges' remarks: - Try: ./schnitzi < schnitzi.c @@ -85,7 +84,6 @@ find out why? ## Author's remarks: - ### SPOILER: This is a program which takes any text file as input and 'flips' diff --git a/1994/shapiro/README.md b/1994/shapiro/README.md index bbd2436ba..8a681220b 100644 --- a/1994/shapiro/README.md +++ b/1994/shapiro/README.md @@ -14,7 +14,7 @@ make all ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -32,7 +32,7 @@ For more detailed information see [1994 shapiro in bugs.md](/bugs.md#1994-shapir ``` -## Try: +### Try: ```sh ./shapiro diff --git a/1994/smr/README.md b/1994/smr/README.md index c60422eee..d8feb706d 100644 --- a/1994/smr/README.md +++ b/1994/smr/README.md @@ -6,24 +6,28 @@ Massachusetts Institute of Technology\ Cambridge, Ma 02139\ US + ## To build: ```sh make all ``` + ## To use: ```sh ./smr ``` -## Try: + +### Try: ```sh ./smr > smr.out ; diff -s smr.out smr.c ``` + ## Judges' remarks: Nearly every year, one or more people would submit what they claimed\ @@ -42,11 +46,13 @@ In the future, the contest rules will specify a minimum size that is one character larger than this entry, forever eliminating this sort of program from the contest. After all, how many variations can one make on this entry? :-) + ## Author's remarks: The world's smallest self-replicating program. Guaranteed. Produces a listing of itself on stdout. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1994/tvr/README.md b/1994/tvr/README.md index 417849c02..3a2852865 100644 --- a/1994/tvr/README.md +++ b/1994/tvr/README.md @@ -6,19 +6,22 @@ Melkonkatu 5 A 8\ 00210 Helsinki\ Finland + ## To build: ```sh make all ``` + ## To use: ```sh ./tvr mode screensize/2 < colormapfile ``` -## Try: + +### Try: ```sh ./tvr 0 128 < tvr.color (for color displays) @@ -49,6 +52,7 @@ The fractally minded may be able to detect that mode 0 does not calculate Mandelbrot/Julian sets correctly. Can you find the bug? Better still, can you fix it without breaking something else? + ## Author's remarks: ### Interactive Fractals for X Window System @@ -216,6 +220,7 @@ should be checked exactly (by comparing `x*x+y*y` with `2*2`), or else artifacts are introduced. The result of this error is a "bubbly" appearance (at least in mono). + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1994/weisberg/README.md b/1994/weisberg/README.md index 078ab44cc..6bcc92372 100644 --- a/1994/weisberg/README.md +++ b/1994/weisberg/README.md @@ -7,6 +7,7 @@ Computer Studies Bldg\ Rochester, NY 14627\ US + ## To build: ```sh @@ -41,6 +42,7 @@ This entry confuses some C-preprocessors and some C-beautifiers. We found one cpp that processed this source differently when it was read on stdin instead of via `cc -E`. + ## Author's remarks: ### Description @@ -72,6 +74,7 @@ speed. It was ported to C specifically for the IOCCC. In the conversion/obfuscation step some of (much of) the blazing speed was lost, but as a bonus, the understandability of the code was reduced to zero. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1994/westley/README.md b/1994/westley/README.md index 378bddeaa..912fe2ecf 100644 --- a/1994/westley/README.md +++ b/1994/westley/README.md @@ -25,7 +25,7 @@ game! There is no running as such. See below. -## Try: +### Try: But for something more interesting try compiling it with different cc arguments. For example: diff --git a/1995/cdua/README.md b/1995/cdua/README.md index 3284e765e..897108564 100644 --- a/1995/cdua/README.md +++ b/1995/cdua/README.md @@ -19,7 +19,7 @@ real time. You can redefine `Z` to reconfigure it in case it's going too slow, too fast :-) or you're doing some strange experiment like making it 100000. -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -37,7 +37,7 @@ For more detailed information see [1995 cdua in bugs.md](/bugs.md#1995-cdua). ``` -## Try: +### Try: To use 1500 for `Z` do: @@ -70,7 +70,7 @@ If you wish to use the original version, for instance if you wish to see how fast your computer is :-) or use both to see the difference, you can do so. -#### Original build: +### Original build: ```sh make all diff --git a/1995/dodsond1/README.md b/1995/dodsond1/README.md index ab03a7017..cc688dcb2 100644 --- a/1995/dodsond1/README.md +++ b/1995/dodsond1/README.md @@ -6,24 +6,28 @@ AG Communication Systems\ Glendale, AZ 85308\ US + ## To build: ```sh make all ``` + ## To use: ```sh ./dodsond1 < text_file ``` -## Try: + +### Try: ```sh ./dodsond1 < README.md ``` + ## Judges' remarks: You might consider giving the following input: @@ -39,6 +43,7 @@ You might consider giving the following input: ./dodsond1 < try.this.txt + ## Author's remarks: Istha ogrampra akesta Englishwa extta aswa inputwa andwa @@ -55,6 +60,7 @@ written as `ainma`. The program construction is also very obfuscated, with all of the code being inside the ()'s of one of the 6 `orfa` loops. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1995/dodsond2/README.md b/1995/dodsond2/README.md index 03d06bf98..28d1bb32d 100644 --- a/1995/dodsond2/README.md +++ b/1995/dodsond2/README.md @@ -3,18 +3,21 @@ Don Dodson\ US + ## To build: ```sh make all ``` + ## To use: ```sh ./dodsond2 ``` + ## Judges' remarks: An amazing entry! @@ -22,6 +25,7 @@ An amazing entry! The official chef enjoyed solving the maze, which she did on the first attempt. + ## Author's remarks: ### Interactive 3D Maze @@ -33,6 +37,7 @@ in an unknown labyrinth, areas which you have not visited cannot be seen. Reach the north-west left corner of level 1 to exit. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1995/esde/README.md b/1995/esde/README.md index c9fe5b9c4..1aaa0df07 100644 --- a/1995/esde/README.md +++ b/1995/esde/README.md @@ -5,12 +5,14 @@ ul. Radzionkowska 71a\ 42-605 Tarnowskie Gory\ Poland + ## To build: ```sh make all ``` + ## To use: ```sh @@ -20,7 +22,7 @@ make all where data-file contains lines of < 255 chars in length. -## Try: +### Try: ```sh ./esde esde.data Johanson @@ -28,6 +30,7 @@ where data-file contains lines of < 255 chars in length. ./esde README.md date ``` + ## Judges' remarks: When reading the source be careful to distinguish between variable @@ -70,6 +73,7 @@ These are the codes: An info file should be a text file consisting of lines of text (max. 256 bytes in each line). + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1995/garry/README.md b/1995/garry/README.md index f8b0ba21f..64cd1c8bb 100644 --- a/1995/garry/README.md +++ b/1995/garry/README.md @@ -18,7 +18,8 @@ make all ./garry output_file ``` -## Try: + +### Try: ```sh @@ -58,10 +59,8 @@ GARRY=garry.alt ./garry.test.sh ``` - ## Judges' remarks: - The author was kind enough to provide a less obfuscated version of the source called [garry.fmt.c](garry.fmt.c). diff --git a/1995/heathbar/README.md b/1995/heathbar/README.md index beacaa400..3c52fd592 100644 --- a/1995/heathbar/README.md +++ b/1995/heathbar/README.md @@ -6,12 +6,14 @@ The Software Bungalow\ Mountain View, CA 94041\ US + ## To build: ```sh make all ``` + ## To use: ```sh @@ -20,7 +22,8 @@ make all where num is a non-negative number. -## Try: + +### Try: ```sh ./heathbar 4253 2281 @@ -32,7 +35,8 @@ where num is a non-negative number. The main reason we liked this entry was mainly because the main effect of the source was self documenting! :-) -## Author's remarks + +## Author's remarks: Run this program with two non-negative integer arguments (e.g. `./heathbar 1234 999`). @@ -66,6 +70,7 @@ diligent effort to write especially clear code gets me extra points! P.S. What does "obfuscated" mean? + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1995/leo/README.md b/1995/leo/README.md index f60602b67..4f244956d 100644 --- a/1995/leo/README.md +++ b/1995/leo/README.md @@ -5,12 +5,14 @@ Leonid A. Broukhis\ Fremont, CA 94539\ US + ## To build: ```sh make all ``` + ## To use: ```sh @@ -19,7 +21,8 @@ make all See the author's information below on these details. -## Try: + +### Try: ```sh ./leo 1 | cat - /dev/tty | gs - @@ -265,6 +268,7 @@ Special thanks: - to Dmitry Mendeleyev for his periodic table of elements; - to Hydrogen for having 2 more isotopes. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1995/makarios/README.md b/1995/makarios/README.md index 1c488776c..dbed9c09f 100644 --- a/1995/makarios/README.md +++ b/1995/makarios/README.md @@ -6,23 +6,27 @@ The Software Bungalow\ Mountain View, CA 94041\ US + ## To build: ```sh make all ``` + ## To use: ```sh ./makarios ``` + ## Judges' remarks: The judges were impressed that such a small program could do so much! Can you figure out how it does it? + ## Author's remarks: This program takes no arguments. It emits the base 8 representation @@ -30,6 +34,7 @@ of prime palindromes (palindromic in base 8, of course). `^_^` + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1995/savastio/README.md b/1995/savastio/README.md index 270a6309f..b132e4beb 100644 --- a/1995/savastio/README.md +++ b/1995/savastio/README.md @@ -6,12 +6,14 @@ Securicor Telesciences\ Philadelphia, PA 19124\ US + ## To build: ```sh make all ``` + ## To use: ```sh @@ -19,16 +21,19 @@ make all # enter a number such as 100 ``` -## Try: + +### Try: ```sh echo 42 | ./savastio ``` + ## Judges' remarks: I know an l when I see a 1. + ## Author's remarks: This program is an infinite-precision factorial calculator. It will @@ -61,6 +66,7 @@ useless factorials, the maximum factorial that can be computed is 429539! This limit was selected through extensive research in time management studies and the factorial arts. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1995/schnitzi/README.md b/1995/schnitzi/README.md index 1d6555379..beb548ed1 100644 --- a/1995/schnitzi/README.md +++ b/1995/schnitzi/README.md @@ -14,13 +14,15 @@ US\ make all ``` + ## To use: ```sh ./schnitzi num ``` -## Try: + +### Try: ```sh ./schnitzi 24 @@ -31,6 +33,7 @@ make all WARNING: the author warns to not use too high a number! If you wish to ignore the warning it is an exercise to determine how high is too high. :-) + ## Judges' remarks: Sometimes a core dump is a feature, not a bug! @@ -38,11 +41,13 @@ Sometimes a core dump is a feature, not a bug! This is one of the better one-liners we have seen in a while. Take some time to figure out what it does before you run it! -## Author's remarks + +## Author's remarks: Beware, running this program with too high of a number amounts to doing a fork bomb on your machine! + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1995/spinellis/README.md b/1995/spinellis/README.md index d85101810..2a1efaa9f 100644 --- a/1995/spinellis/README.md +++ b/1995/spinellis/README.md @@ -5,20 +5,22 @@ Greece\ \ Mastodon: + ## To build: ```sh make all ``` + ## To use: ```sh ./spinellis < spinellis.c ``` -## Judges' remarks: +## Judges' remarks: While the code does not abuse the rules, its output surely does! @@ -36,6 +38,7 @@ so heavily commented. This program is exactly 3217 characters long through judicious use of white space. Rule abuse? Would I _ever_ abuse the rules? + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1995/vanschnitz/README.md b/1995/vanschnitz/README.md index ab772c7c2..af165a67f 100644 --- a/1995/vanschnitz/README.md +++ b/1995/vanschnitz/README.md @@ -7,6 +7,7 @@ Suite 120\ Marietta, GA 30067\ US + ## To build: ```sh @@ -14,7 +15,7 @@ make all ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -31,7 +32,8 @@ For more detailed information see [1995 vanschnitz in bugs.md](/bugs.md#1995-van ./vanschnitz ``` -## Try: + +### Try: ```sh make clobber all LEVEL=6 @@ -196,6 +198,7 @@ to try to decipher the program without it... ` end + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1996/august/README.md b/1996/august/README.md index dbb86ad60..45ed49fe6 100644 --- a/1996/august/README.md +++ b/1996/august/README.md @@ -11,7 +11,7 @@ make all ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -37,7 +37,7 @@ very short amount of time, then you may need to fix your compiler or use gcc. The above should print a `!` followed by a newline. -## Try: +### Try: ```sh cat august.c fac.oc | ./august > fac.oo diff --git a/1996/dalbec/README.md b/1996/dalbec/README.md index 6b5803f86..6f9235641 100644 --- a/1996/dalbec/README.md +++ b/1996/dalbec/README.md @@ -20,7 +20,8 @@ make all ./dalbec ``` -## Try: + +### Try: ```sh ./dalbec 3 | head -n 29 diff --git a/1996/eldby/README.md b/1996/eldby/README.md index c4558b33f..af4dbeafc 100644 --- a/1996/eldby/README.md +++ b/1996/eldby/README.md @@ -22,7 +22,8 @@ see the [original code](#original-code) section. NOTE: to reset the sanity of your terminal after this program ends try `reset`. -## Try: + +### Try: This alternate version, which we recommend that you use in order to see what is happening with modern systems, and to not flash too quickly, which can be @@ -35,6 +36,7 @@ make CFLAGS+="-DZ=20000" clobber alt ./eldby.alt ``` + ## Original code: Besides the fact that modern systems make it impossible to see what this program diff --git a/1996/gandalf/README.md b/1996/gandalf/README.md index 586836317..a6502f91f 100644 --- a/1996/gandalf/README.md +++ b/1996/gandalf/README.md @@ -16,7 +16,7 @@ make all ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -33,7 +33,8 @@ For more detailed information see [1996 gandalf in bugs.md](/bugs.md#1996-gandal ./gandalf ``` -## Try: + +### Try: ```sh PATH=.:$PATH diff --git a/1996/huffman/README.md b/1996/huffman/README.md index 9a9f7d577..bff46c80d 100644 --- a/1996/huffman/README.md +++ b/1996/huffman/README.md @@ -8,12 +8,14 @@ US\ \ huffmancoding@gmail.com + ## To build: ```sh make all ``` + ## To use: ```sh @@ -23,7 +25,8 @@ echo 'Huffman Decoding' | ./huffman NOTE: this program uses `gets()` so you will likely get a warning when compiling and/or running on modern systems. -## Try: + +### Try: ```sh echo 'seeing or feeling is believing' | ./huffman @@ -47,6 +50,7 @@ And if you really can't see what is going on, here is an extra spoiler: This entry was very well received at the IOCCC BOF. + ## Author's remarks: This filter program is really not obfuscated code. It compiles cleanly @@ -63,6 +67,7 @@ to the executable. This program is best appreciated on a tactile monitor. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1996/jonth/README.md b/1996/jonth/README.md index 72c9ef008..06ff957f3 100644 --- a/1996/jonth/README.md +++ b/1996/jonth/README.md @@ -7,6 +7,7 @@ N 0372 Oslo\ Norway\ http://www.uio.no/~jonth/ + ## To build: ```sh @@ -19,7 +20,7 @@ install [XQuartz](https://www.xquartz.org) in order to compile and run this entry. -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -36,18 +37,20 @@ For more detailed information see [1996 jonth in bugs.md](/bugs.md#1996-jonth). ./jonth :0 :0 ``` -## Try: + +### Try: ```sh ./jonth host1:0 host2:0 ``` -## Judges' remarks: +## Judges' remarks: For extra credit, figure out how you can cheat by taking over a square already occupied by an opponent. + ## Author's remarks: This is multi-user tic-tac-toe for X Windows. You may give one or two X displays @@ -63,6 +66,7 @@ If one (or both) windows look like a copy of the window(s) below, try Have a `nice(1)` day. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1996/rcm/README.md b/1996/rcm/README.md index 042a9bb50..222d08dae 100644 --- a/1996/rcm/README.md +++ b/1996/rcm/README.md @@ -5,19 +5,22 @@ Ron McFarland\ Cincinnati, Ohio 45249\ US + ## To build: ```sh make all ``` + ## To use: ```sh ./rcm < rfc1951.gz ``` -## Try: + +### Try: For more information try: @@ -25,6 +28,7 @@ For more information try: ./rcm < rfc1952.gz ``` + ## Judges' remarks: For a good noop try: @@ -33,6 +37,7 @@ For a good noop try: gzip -c < rcm.c | ./rcm ``` + ## Author's remarks: Except for some silly requirements regarding input validation, CRC checking, and @@ -76,6 +81,7 @@ of constants and tables be defined. Which means the program itself had to be squeezed down to about 1,100 IOCCC countable bytes." + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1996/schweikh1/README.md b/1996/schweikh1/README.md index c6fe38e80..5830ef858 100644 --- a/1996/schweikh1/README.md +++ b/1996/schweikh1/README.md @@ -7,19 +7,22 @@ D-71384 Weinstadt\ Germany\ + ## To build: ```sh make all ``` + ## To use: ```sh ./schweikh1 ``` -## Try: + +### Try: To find the day that Easter falls on in the current year: @@ -37,6 +40,7 @@ statement? Clearly this is either the Best Use or the Worst Abuse of the C Preprocessor that the judges have seen this year! + ## Author's remarks: ### What this program does @@ -140,6 +144,7 @@ problems on other systems. The program is run without arguments. It prints all dates in order. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1996/schweikh2/README.md b/1996/schweikh2/README.md index abf0971a1..f0c0d5342 100644 --- a/1996/schweikh2/README.md +++ b/1996/schweikh2/README.md @@ -14,6 +14,7 @@ Germany\ make all ``` + ## To use: ```sh @@ -31,7 +32,7 @@ The program accepts up to 4 parameters: 3. The goal value or 0/0 [default: 42] -## Try: +### Try: ```sh ./schweikh2 15 1 0 0/0 @@ -55,7 +56,6 @@ while :; do grep -v '#' schweikh2.c; done ## Judges' remarks: - The original program, with only slight obfuscations, may be found in `hunni.c`. The perl script, obfuscates it appropriately: @@ -65,6 +65,7 @@ perl ./hunni.pl < hunni.c This entry was another crowd pleaser at the IOCCC BOF. + ## Author's remarks: Note: the source must be viewed with tabstop 8. To appreciate the @@ -159,6 +160,7 @@ For a nice printout try this on your Bourne compatible shell: % while :; do grep -v '#' schweikh2.c; done ``` + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1996/schweikh3/README.md b/1996/schweikh3/README.md index 1f2877715..0690efa9e 100644 --- a/1996/schweikh3/README.md +++ b/1996/schweikh3/README.md @@ -7,12 +7,14 @@ D-71384 Weinstadt\ Germany\ + ## To build: ```sh make all ``` + ## To use: **WARNING: DO NOT RUN this program without reading this text down to the end!** @@ -24,6 +26,7 @@ You have been warned. ./schweikh3 ``` + ## Judges' remarks: The source fails to compile on compilers that recognize the inline @@ -48,6 +51,7 @@ NOTE: On some systems such as SunOS, one may need to compile with: schweikh3.c -o schweikh3 ``` + ## Author's remarks: ### Why I think my entry is obfuscated @@ -171,6 +175,7 @@ value returned by time seems to 'hang' sometimes when the OS thrashes. Exceeding a threshold of 5 seconds may be detected only after half a minute or so. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1996/westley/README.md b/1996/westley/README.md index d18e33172..dcfedd807 100644 --- a/1996/westley/README.md +++ b/1996/westley/README.md @@ -25,8 +25,8 @@ NOTE: the original version had a display problem in modern systems which somewhat affected the usability of the program. See the Alternate code section for details on the original version. -## Try: +### Try: ```sh sh ./clock2 diff --git a/1998/banks/README.md b/1998/banks/README.md index 97acb6493..9dfa08677 100644 --- a/1998/banks/README.md +++ b/1998/banks/README.md @@ -7,18 +7,21 @@ University Park, PA 16802\ US\ + ## To build: ```sh make all ``` + ## To use: ```sh cat horizon.sc pittsburgh.sc | ./banks ``` + ## Judges' remarks: What can we say? It's a flight sim done in 1536 bytes of real code. @@ -33,6 +36,7 @@ Carl Banks linked to (on his old website) an interesting article about this entry, a flight simulator in just 1536 bytes, which can be found at . + ## Author's remarks: You have just stepped out of the real world and into the @@ -202,6 +206,7 @@ The best advice is to set time step size to your system timer resolution. Try a longer period if you're getting too much flicker. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1998/bas1/README.md b/1998/bas1/README.md index f45bc1381..b50661b07 100644 --- a/1998/bas1/README.md +++ b/1998/bas1/README.md @@ -6,12 +6,14 @@ Statenweg 154 B (home address)\ 3039 JN Rotterdam\ The Netherlands + ## To build: ```sh make all ``` + ## To use: If `lpr` on your system can print PostScript: @@ -32,6 +34,7 @@ or: ./bas1 | gunzip | gs -sDEVICE=pgmraw -sOutputFile='|xv -' - ``` + ## Judges' remarks: The output is supposed to be a 3D maze, but it is somewhat more @@ -41,7 +44,8 @@ Escher's](https://en.wikipedia.org/wiki/M._C._Escher) When trying to run the program with command line arguments, be generous. -## Author's remarks + +## Author's remarks: ### BEMAZING @@ -83,6 +87,7 @@ happens. (But note that the program only guarantees that there actually is a route from entrance to exit if you run it without command line arguments.) + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1998/bas2/README.md b/1998/bas2/README.md index 0f28dd9be..83e94461b 100644 --- a/1998/bas2/README.md +++ b/1998/bas2/README.md @@ -6,18 +6,21 @@ Statenweg 154 B (home address)\ 3039 JN Rotterdam\ The Netherlands + ## To build: ```sh make all ``` + ## To use: ```sh ./bas2 < bas2.c ``` + ## Judges' remarks: ### Questions to ponder: @@ -36,6 +39,7 @@ a way that differs from a strict reading of one of the official IOCCC rules. What is the rule and what is the octet value? + ## Author's remarks: The main obfuscation is the way characters are recognized, which is @@ -50,6 +54,7 @@ the character). - `?` and `||` instead of if statements. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1998/chaos/README.md b/1998/chaos/README.md index 7fce5c338..a75e6bc5f 100644 --- a/1998/chaos/README.md +++ b/1998/chaos/README.md @@ -25,7 +25,6 @@ make chaos_nohalf ## To use: - ```sh ./chaos ``` diff --git a/1998/df/README.md b/1998/df/README.md index 7acb66431..06ff2e73b 100644 --- a/1998/df/README.md +++ b/1998/df/README.md @@ -6,12 +6,14 @@ Salenbergstrasse 11 (home address)\ D 72250 Freudenstadt\ German Federal Republic + ## To build: ```sh make all ``` + ## To use: ```sh @@ -41,6 +43,7 @@ Extra credit questions: - How many words does this entry use? - Can you add more words to the program and still make it work? + ## Author's remarks: This program lets you guess English words. It displays an underscore @@ -150,6 +153,7 @@ this function. Similarly, most indexing operations have been changed to this form; and I tried to write each such operation different. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1998/dlowe/README.md b/1998/dlowe/README.md index 2d3e9eade..562ee2d1f 100644 --- a/1998/dlowe/README.md +++ b/1998/dlowe/README.md @@ -5,12 +5,14 @@ US\ + ## To build: ```sh make all ``` + ## To use: ```sh @@ -18,7 +20,7 @@ make all ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -29,7 +31,7 @@ STATUS: missing or dead link - please provide them For more detailed information see [1998 dlowe in bugs.md](/bugs.md#1998-dlowe). -## Try: +### Try: ```sh ./dlowe < README.md @@ -51,6 +53,7 @@ make dlowe.alt What's the difference between this and `dlowe`? + ## Judges' remarks: Why could this this entry be considered a utility? Well because it @@ -97,6 +100,7 @@ For further information see: https://web.archive.org/web/20040326083431/http://www.pootpoot.com/poot/pootify/?URL=http%3A%2F%2Fwww.ioccc.org ``` + ## Author's remarks: This program is a text filter, it reads stdin and outputs the @@ -112,6 +116,7 @@ enjoyment; use it to turn the GPL into the `PPL`; see what happens when you run `perl4` programs after they've been run through it; "encrypt" sensitive (but unnecessary) documents... + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1998/dloweneil/README.md b/1998/dloweneil/README.md index 1bb2b80cc..e1a393373 100644 --- a/1998/dloweneil/README.md +++ b/1998/dloweneil/README.md @@ -7,6 +7,7 @@ US\ Neil Mix\ US + ## To build: ```sh @@ -14,8 +15,7 @@ make all ``` - -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -41,6 +41,7 @@ of the playing field. Pressing `d` drops the current letter onto the board. + ## Judges' remarks: Read the authors' remarks below to find out how to play. We believe that your @@ -50,6 +51,7 @@ experience may mirror one of our experiences: > description of the controls. I started playing. I struggled. > I spelled my first "poot". I was hooked ... + ## Author's remarks: ### Usage @@ -161,6 +163,7 @@ places. Good Luck! + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1998/dorssel/README.md b/1998/dorssel/README.md index 69a67b8f8..74b4069cc 100644 --- a/1998/dorssel/README.md +++ b/1998/dorssel/README.md @@ -6,12 +6,14 @@ Kaiserstraat 35\ NL-2311 GP Leiden\ The Netherlands + ## To build: ```sh make all ``` + ## To use: ```sh @@ -21,7 +23,8 @@ make all echo text | ./dorssel ``` -## Try: + +### Try: ```sh echo Simple as 123 | ./dorssel @@ -31,6 +34,7 @@ echo 'HOW DOES IT DO THAT' | ./dorssel echo 'HOW DOES IT DO THAT' | ./dorssel | ./dorssel ``` + ## Judges' remarks: How does the program decide which way to convert? @@ -56,6 +60,7 @@ Extra credit: Change the program so that it does not SHOUT IN ALL CAPS. You might also want to read the [dorssel.md](dorssel.md) file. + ## Author's remarks: ### Usage @@ -115,6 +120,7 @@ understand this program. For an obfuscated spoiler, try ./dorssel < dorssel.md\ ``` + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1998/fanf/README.md b/1998/fanf/README.md index 09b783e6f..44147f999 100644 --- a/1998/fanf/README.md +++ b/1998/fanf/README.md @@ -4,6 +4,7 @@ Tony Finch United Kingdom + ## To build: ```sh @@ -13,6 +14,7 @@ make all NOTE: This may take a while. Some systems may have problems building\ this entry because of the system resources it requires. + ## To use: ```sh @@ -47,6 +49,7 @@ sample expressions that you can use: ) ``` + ## Judges' remarks: This program translates lambda expressions into combinator @@ -79,6 +82,7 @@ combinator expressions on standard output. What do you have to do to make this program work with an old non-ANSI C preprocessor? + ## Author's remarks: My program is a demonstration of some practical applications of @@ -420,6 +424,7 @@ conference on Lisp and Functional Programming, 1990. Wadler, P., 1995. How to Declare an Imperative. Proceedings of the ACM International Logic Programming Symposium, 1995. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1998/schnitzi/README.md b/1998/schnitzi/README.md index fc908cf1f..4470ae395 100644 --- a/1998/schnitzi/README.md +++ b/1998/schnitzi/README.md @@ -12,7 +12,7 @@ make all ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -37,7 +37,7 @@ echo x y z | ./sort where `n` and `x`, `y` and `z` are numbers. -## Try: +### Try: ```sh ./try.sh diff --git a/1998/schweikh1/README.md b/1998/schweikh1/README.md index be4efe5d6..1e49b1875 100644 --- a/1998/schweikh1/README.md +++ b/1998/schweikh1/README.md @@ -113,6 +113,7 @@ Use `schweikh1.alt` as you would `schweikh1` above. Bonus exercise: modify the code to provide a different compiler. + ## Judges' remarks: What does it do? It seems to print a list of system headers, perhaps diff --git a/1998/schweikh2/README.md b/1998/schweikh2/README.md index b43b33b6b..84ceb5f37 100644 --- a/1998/schweikh2/README.md +++ b/1998/schweikh2/README.md @@ -11,8 +11,8 @@ Germany\ make all ``` -## To use: +## To use: ```sh ./yarng @@ -24,7 +24,8 @@ or ./yarng integer_number ``` -## Try: + +### Try: ```sh ./yarng 5 @@ -249,6 +250,7 @@ load, number and temporal distribution of asynchronous events and last but not least the phase of the moon. God _does_ play dice. Type `yarng` and watch Him roll. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1998/schweikh3/README.md b/1998/schweikh3/README.md index 44efc8c70..47131411c 100644 --- a/1998/schweikh3/README.md +++ b/1998/schweikh3/README.md @@ -7,12 +7,14 @@ D-71384 Weinstadt\ Germany\ + ## To build: ```sh make all ``` + ## To use: If "dir" is the directory (or a directory tree) where you keep @@ -25,7 +27,8 @@ find dir -type f -print | ./schweikh3 Maybe you will not need to buy another 10 Gb disk to store them. :-) -## Try: + +### Try: If you're in this winning entry's directory: @@ -38,7 +41,6 @@ Notice that the tool finds a duplicate file, that of the man page. ## Judges' remarks: - Try this: ```sh @@ -58,7 +60,8 @@ anyway. :-) NOTE: Some non-gcc compilers that are not fully ANSI standard do not compile this entry correctly. -## Author's remarks + +## Author's remarks: The source is expected to conform to IEEE Std 1003.1-1990 ("POSIX"). Thank God the IEEE does not standardize a coding style... @@ -225,6 +228,7 @@ the same size (on systems where `sizeof (char *) == 4`, or 4096 when `sizeof (char *) == 8`), increase the manifest constant 32767 on line 31. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/1998/tomtorfs/README.md b/1998/tomtorfs/README.md index 0d893f0e6..bdff11482 100644 --- a/1998/tomtorfs/README.md +++ b/1998/tomtorfs/README.md @@ -7,19 +7,22 @@ Cuperuslei 12 (home address)\ Belgium\ + ## To build: ```sh make all ``` + ## To use: ```sh ./tomtorfs tomtorfs.c 32 04C11DB7 1 FFFFFFFF FFFFFFFF ``` -## Try: + +### Try: ```sh echo "abscond conferrable" > file.A @@ -30,12 +33,14 @@ echo "adorn condolence too" > file.C ./tomtorfs file.C 32 04C11DB7 1 FFFFFFFF FFFFFFFF ``` + ## Judges' remarks: If you don't believe the program is correct, try and compare the output of the program with the value of CRC computed by PKZIP or any other archiver that uses the CRC-32 algorithm. + ## Author's remarks: ``` @@ -132,6 +137,7 @@ at them they should become obvious also. Ross N. Williams, whose CRC guide was very useful to me for writing this. You can find it in [crc.txt](crc.txt). + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2000/anderson/README.md b/2000/anderson/README.md index 34ed3bfe8..7d1c1c180 100644 --- a/2000/anderson/README.md +++ b/2000/anderson/README.md @@ -21,7 +21,7 @@ echo something | ./anderson ``` -## Try: +### Try: ```sh echo Obfuscate | ./anderson diff --git a/2000/bellard/README.md b/2000/bellard/README.md index 78bc629e5..619c16535 100644 --- a/2000/bellard/README.md +++ b/2000/bellard/README.md @@ -6,24 +6,28 @@ Fabrice Bellard\ France\ + ## To build: ```sh make ``` + ## To use: ```sh ./bellard ``` -## Try: + +### Try: ```sh Do. Or do not. There is no try. :-) ``` + ## Judges' remarks: This code is a nice compact example of a Modular Fast Fourier Transform. While @@ -45,6 +49,7 @@ of time (the usual method would take ages !). The program uses >= 64 bit 'long long' type. It should run on any system with a gcc compiler. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2000/bmeyer/README.md b/2000/bmeyer/README.md index 5d437da96..d68f1c716 100644 --- a/2000/bmeyer/README.md +++ b/2000/bmeyer/README.md @@ -7,19 +7,23 @@ Clayton, VIC 3168\ Australia\ \ \ + + ## To build: ```sh make ``` + ## To use: ```sh ./bmeyer ``` -## Try: + +### Try: In a video window (white text on black background): @@ -66,6 +70,7 @@ Decompress that smaller glic-file: Compare the `new.pgm` file to the [lavabus.pgm](lavabus.pgm) file by viewing them. + ## Judges' remarks: Don't even think of supplying different compression factors (the @@ -104,6 +109,7 @@ chance any given file produced might not be portable. The [Makefile](Makefile) defaults to `-O3` and no `asm()` call. + ## Author's remarks: This program is called `GLICBAWLS` @@ -384,6 +390,7 @@ en/decoded\[4\]. for image compression testing for so long, it was now a useful benchmark. (Note: This picture doesn't show very much.) + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2000/briddlebane/README.md b/2000/briddlebane/README.md index 9f9daa91a..a940f8a41 100644 --- a/2000/briddlebane/README.md +++ b/2000/briddlebane/README.md @@ -18,7 +18,8 @@ make ./briddlebane ``` -## Try: + +### Try: For some fun every time you log in try running this from your `.bashrc` or equivalent file! diff --git a/2000/dhyang/README.md b/2000/dhyang/README.md index 263243bb1..274ee322c 100644 --- a/2000/dhyang/README.md +++ b/2000/dhyang/README.md @@ -7,19 +7,22 @@ Covina, CA 91722\ US\ + ## To build: ```sh make ``` + ## To use: ```sh ./dhyang ``` -## Try: + +### Try: ```sh make saitou @@ -38,6 +41,7 @@ make aku ./aku | diff - aku.c ``` + ## Judges' remarks: A beautiful combination of solving several different problems, but @@ -47,6 +51,7 @@ programs have *one* interesting layout; this one has four. It may be informative to run the code through a "beautifier", to study it, but the layout itself is where most of the interest lies. + ## Author's remarks: This one is dedicated to Saitou Hajime fans `^_^x` @@ -74,6 +79,7 @@ but you know, size... character set. No file is included and all functions assume default int return type (a source of compile warnings). + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2000/dlowe/README.md b/2000/dlowe/README.md index 00cea706b..66302afa4 100644 --- a/2000/dlowe/README.md +++ b/2000/dlowe/README.md @@ -24,7 +24,8 @@ perl -MConfig -e 'print "$Config{archlibexp}/CORE\n"' ./dlowe [file ...] ``` -## Try: + +### Try: ```sh echo "13 14 15 16 17 + - * / p" | ./dlowe diff --git a/2000/jarijyrki/README.md b/2000/jarijyrki/README.md index 60082d849..8bda3450e 100644 --- a/2000/jarijyrki/README.md +++ b/2000/jarijyrki/README.md @@ -31,7 +31,7 @@ You will need X11 header files and libraries installed to build this program. You will need a system capable of displaying the results of X Window programs. -## Try: +### Try: ```sh ./jarijyrki < finance.sheet > myedits.info diff --git a/2000/natori/README.md b/2000/natori/README.md index 3a476a53b..3f2742285 100644 --- a/2000/natori/README.md +++ b/2000/natori/README.md @@ -21,7 +21,7 @@ NOTE: an alternate version exists for those in the southern hemisphere. See the Alternate code section below for more details. -## Try: +### Try: Try modifying the code so that it will show another Moon phase based on input or else just by the code itself. Bonus points if you can make it show all! diff --git a/2000/primenum/README.md b/2000/primenum/README.md index 1f9fb124e..b14fff5b3 100644 --- a/2000/primenum/README.md +++ b/2000/primenum/README.md @@ -10,7 +10,7 @@ make ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -31,7 +31,7 @@ echo n | ./primenum n NOTE: `n` is an integer. -## Try: +### Try: ```sh echo IOCCC 23209 | ./primenum 23209 @@ -105,6 +105,7 @@ argument, otherwise the "bugs" in the program will cause it to crash! - Try also `echo THIS MESSAGE IS IN ALL CAPS | ./primenum 32` + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2000/rince/README.md b/2000/rince/README.md index 7a241e924..f0531af33 100644 --- a/2000/rince/README.md +++ b/2000/rince/README.md @@ -7,6 +7,7 @@ Cambridge\ CB2 2QH\ England + ## To build: ```sh @@ -14,7 +15,7 @@ make ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -36,13 +37,15 @@ For more detailed information see [2000 rince in bugs.md](/bugs.md#2000-rince). If `DISPLAY` is not set the program will very likely crash or do something different. -## Try: + +### Try: ```sh make dmy2jd ./rince 0.001 `./dmy2jd 7.8 1 1610` ``` + ## Judges' remarks: This program may have you going around in circles :-) Try running it first @@ -51,6 +54,7 @@ before reading the author's remarks below. The judges verified the correctness of output for recent dates through visual observation. + ## Author's remarks: ### How to use it @@ -361,6 +365,7 @@ Jean Meeus. Published by Willmann-Bell Inc. [2] Astronomical algorithms (1st ed): pages 285-299. Jean Meeus. Published by Willmann-Bell Inc. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2000/robison/README.md b/2000/robison/README.md index 3b140ff82..0aaca269d 100644 --- a/2000/robison/README.md +++ b/2000/robison/README.md @@ -5,24 +5,28 @@ Arch D. Robison\ Champaign IL 61821\ US + ## To build: ```sh make ``` + ## To use: ```sh ./robison ``` -## Try: + +### Try: ```sh echo "Do or do not. There is no try." ``` + ## Judges' remarks: The program plays almost always reasonably, but does not always detect @@ -34,6 +38,7 @@ a game when its position is hopeless. Unfortunately, due to the contest rules, we're unable to grant the author a patent he applied for. :-) + ## Author's remarks: ### TITLE OF INVENTION @@ -183,6 +188,7 @@ I claim, by letters patently absurd: [See attached listing.] + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2000/schneiderwent/README.md b/2000/schneiderwent/README.md index ded77994d..bee4687c0 100644 --- a/2000/schneiderwent/README.md +++ b/2000/schneiderwent/README.md @@ -3,19 +3,22 @@ Craig Schneiderwent\ WI, US + ## To build: ```sh make ``` + ## To use: ```sh ./schneiderwent datafile ``` -## Try: + +### Try: ```sh ./schneiderwent schneiderwent.data @@ -24,6 +27,7 @@ make What's the difference? + ## Judges' remarks: Very nice play by the rules and portable text obfuscation. @@ -34,6 +38,7 @@ Translating the messages into your language of preference while keeping the program portable between different encodings (Chinese, Japanese, Russian - anyone?) may be an entertaining task. + ## Author's remarks: This entry displays the current time to the console, for example: @@ -76,6 +81,7 @@ setjmp/longjmp combination. judges - it's just the easiest way to get around the absence of square brackets in a normal 3270 environment. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2000/thadgavin/README.md b/2000/thadgavin/README.md index 63f35a518..4bf710bcc 100644 --- a/2000/thadgavin/README.md +++ b/2000/thadgavin/README.md @@ -39,7 +39,7 @@ program as the program does not call `endwin()`. Using `reset` will clear the screen. -## Try: +### Try: ```sh echo "Do or do not. There is no try." diff --git a/2000/tomx/README.md b/2000/tomx/README.md index 876a32680..a0d9fcb6c 100644 --- a/2000/tomx/README.md +++ b/2000/tomx/README.md @@ -7,19 +7,22 @@ Nalanchira P.O, Trivandrum-695015\ India\ + ## To build: ```sh make ``` + ## To use: ```sh ./tomx ``` -## Try: + +### Try: ```sh rm -f ./tomx @@ -36,6 +39,7 @@ make -f tomx.c ./tomx ``` + ## Judges' remarks: Polyglots have come and gone, but this was the first one we'd seen @@ -44,6 +48,7 @@ approach. Admittedly, it's not all that obfuscated - but there's more to it than you might think, since you have to make sure that your changes don't change the shell code or the Makefile. + ## Author's remarks: ### Summary @@ -113,6 +118,7 @@ do the same as `make clean` :-)). Also: `./tomx.c all` 5. Be careful about the tabs in the source code. Removing them or converting tabs to spaces can be disastrous. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2001/anonymous/README.md b/2001/anonymous/README.md index 15fdf841a..f1b51a416 100644 --- a/2001/anonymous/README.md +++ b/2001/anonymous/README.md @@ -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 [2001 anonymous in bugs.md](/bugs.md#2001-anon ``` -## Try: +### Try: ```sh ./try.sh @@ -86,6 +86,7 @@ to be correct. Is emulation the sincerest form of flattery? This small program does quite a lot of bit twiddling. + ## Author's remarks: This program is an optimizing dynamic binary translator, allowing you to diff --git a/2001/bellard/README.md b/2001/bellard/README.md index 5aa21e656..86d12cd60 100644 --- a/2001/bellard/README.md +++ b/2001/bellard/README.md @@ -11,7 +11,7 @@ make ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -30,7 +30,7 @@ For more detailed information see [2001 bellard in bugs.md](/bugs.md#2001-bellar ``` -## Try: +### Try: ```sh ./bellard bellard.otccex.c diff --git a/2001/cheong/README.md b/2001/cheong/README.md index d2512f4f7..0b9400571 100644 --- a/2001/cheong/README.md +++ b/2001/cheong/README.md @@ -11,6 +11,7 @@ US\ make ``` + ## To use: ```sh @@ -18,7 +19,7 @@ make ``` -## Try: +### Try: ```sh ./cheong 1024 diff --git a/2001/coupard/README.md b/2001/coupard/README.md index 9d0f37ae6..d41e2b735 100644 --- a/2001/coupard/README.md +++ b/2001/coupard/README.md @@ -22,7 +22,7 @@ make ``` -## Try: +### Try: ```sh ./coupard > /dev/audio diff --git a/2001/ctk/README.md b/2001/ctk/README.md index 67243dc12..1fa7ef800 100644 --- a/2001/ctk/README.md +++ b/2001/ctk/README.md @@ -20,7 +20,7 @@ make ``` -## Try: +### Try: ```sh echo "Do or do not. There is no try." diff --git a/2001/dgbeards/README.md b/2001/dgbeards/README.md index a7b3dfe6d..a3b31a1f7 100644 --- a/2001/dgbeards/README.md +++ b/2001/dgbeards/README.md @@ -11,7 +11,7 @@ make ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -49,7 +49,7 @@ version that the author did not note? This game crashes if it loses. -## Try: +### Try: See if you can figure out how to make the computer always lose. It's a very simple thing to do. Read the author's remarks for clues. diff --git a/2001/herrmann1/README.md b/2001/herrmann1/README.md index 74734ec1f..cb4809347 100644 --- a/2001/herrmann1/README.md +++ b/2001/herrmann1/README.md @@ -12,7 +12,7 @@ make ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -38,7 +38,7 @@ NOTE: some files are missing and are not found in the archive either. See [bugs.md](/bugs.md) for more details. -## Try: +### Try: ```sh ./herrmann1.sh 'prg=herrmann1.times2' @@ -50,6 +50,7 @@ NOTE: some files are missing and are not found in the archive either. See ./herrmann1.sh 'prg=herrmann1.gcd' ``` + ## Judges' remarks: There are some clear hints in the source code as to the @@ -58,6 +59,7 @@ going on is to look at the differences between the runs of the C preprocessor! Computer Science students should recognize what is going on. + ## Author's remarks: Many cool things have been done with the preprocessor, @@ -394,6 +396,7 @@ beginning. - On SunOS, I had to remove the `-q` option from diff in the build script. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2001/herrmann2/README.md b/2001/herrmann2/README.md index 11ee4975c..7d9ffa8ac 100644 --- a/2001/herrmann2/README.md +++ b/2001/herrmann2/README.md @@ -18,7 +18,8 @@ make ./herrmann2 ``` -## Try: + +### Try: ```sh ./herrmann2 < herrmann2.ioccc diff --git a/2001/jason/README.md b/2001/jason/README.md index b2469ba3e..3d043ecb5 100644 --- a/2001/jason/README.md +++ b/2001/jason/README.md @@ -6,24 +6,28 @@ Nashua, NH 03060 US + ## To build: ```sh make ``` + ## To use: ```sh ./jason ``` -## Try: + +### Try: ```sh echo "Do or do not. There is no try." ``` + ## Judges' remarks: You are in a maze of twisty little passages, all alike. @@ -38,6 +42,7 @@ expect that from something this small. Of particular interest: Go ahead, run it through the preprocessor. You *still* won't see the words that are used in the game. + ## Author's remarks: TED Shroyer came up with the idea that made it possible to hide all @@ -135,6 +140,7 @@ The trick, of course, is to drop items in empty rooms to mark them. That way you usually know if you're in a room you've seen before. It greatly aids mapping. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2001/kev/README.md b/2001/kev/README.md index 89d5b4ade..9b6819535 100644 --- a/2001/kev/README.md +++ b/2001/kev/README.md @@ -13,7 +13,7 @@ make ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -45,7 +45,7 @@ There is an alternate version which lets you use the arrow keys to control your paddle. See below Alternate code. -## Try: +### Try: ```sh ./kev\ @@ -80,7 +80,6 @@ box. ## Author's remarks: - **NETWORK PONG!** ### REQUIREMENTS diff --git a/2001/ollinger/README.md b/2001/ollinger/README.md index f9aabad0f..fe0e08265 100644 --- a/2001/ollinger/README.md +++ b/2001/ollinger/README.md @@ -4,6 +4,7 @@ Nicolas Ollinger France + ## To build: ```sh @@ -11,7 +12,7 @@ make ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -32,7 +33,8 @@ For more detailed information see [2001 ollinger in bugs.md](/bugs.md#2001-ollin This program will very likely crash or do something else without an arg. -## Try: + +### Try: ```sh ./ollinger 1000 | cut -c -200 @@ -41,10 +43,12 @@ This program will very likely crash or do something else without an arg. Try the above command in a large window, say 200 chars wide and 100 high (200x100) with a tiny font. + ## Judges' remarks: Do get lost in the programs line of thought! :-) + ## Author's remarks: ### What's this? @@ -123,6 +127,7 @@ The main loop simply iterates this transition function on each cell. Enjoy! + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2001/rosten/README.md b/2001/rosten/README.md index c58012354..e0641e7f5 100644 --- a/2001/rosten/README.md +++ b/2001/rosten/README.md @@ -4,12 +4,14 @@ Edward Rosten\ UK\ + ## To build: ```sh make ``` + ## To use: ```sh @@ -21,7 +23,8 @@ program. Use at your own risk. NOTE: number is floating point. -## Try: + +### Try: ```sh ./rosten 1.03 @@ -34,11 +37,13 @@ For some abuse, try: ./rosten 0.99 ``` + ## Judges' remarks: Friction can be your friend if it does not rub you (or your mouse cursor) in the wrong way. :-) + ## Author's remarks: ### NAME @@ -156,6 +161,7 @@ can't compile the code. It thinks that preprocessor lines can not have whitespace preceding the `#`. Moving the preprocessor directives to the beginning of the line wrecks the layout but makes it compile. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2001/schweikh/README.md b/2001/schweikh/README.md index af487a8fd..463c953c1 100644 --- a/2001/schweikh/README.md +++ b/2001/schweikh/README.md @@ -4,6 +4,7 @@ Jens Schweikhardt\ Germany\ + ## To build: ```sh @@ -11,7 +12,7 @@ make ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -38,7 +39,8 @@ comments for details and a workaround. There's also no way to escape meta characters. -## Try: + +### Try: ```sh ./schweikh foo 'f??'; echo $? @@ -46,10 +48,12 @@ There's also no way to escape meta characters. ./schweikh bar 'f??'; echo $? ``` + ## Judges' remarks: Do you get the pattern here? + ## Author's remarks: This one-liner program is a glob pattern matcher. It understands @@ -102,6 +106,7 @@ How does it deal with sequences of adjacent `*`? How could this be improved? If all else fails, recode the `?:` operators with if/else and try again. For extra credit implement character classes like `[a-z]`. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2001/westley/README.md b/2001/westley/README.md index 2a95f9eba..e13d400e2 100644 --- a/2001/westley/README.md +++ b/2001/westley/README.md @@ -19,7 +19,7 @@ make ``` -## Try: +### Try: ```sh ./westley.sh diff --git a/2001/williams/README.md b/2001/williams/README.md index a403f12e4..a6e79fc22 100644 --- a/2001/williams/README.md +++ b/2001/williams/README.md @@ -3,24 +3,28 @@ John Williams US + ## To build: ```sh make ``` + ## To use: ```sh ./williams ``` -## Try: + +### Try: ```sh echo "Do or do not. There is no try." ``` + ## Judges' remarks: [A strange game. The only winning move is not to @@ -32,6 +36,7 @@ the standard "three triangles around a circular" logo for nukes. This is a pretty straightforward game. + ## Author's remarks: What this program does: @@ -63,6 +68,7 @@ arithmetic, resulting in the overuse of bitwise shift operators. Another example is `(x|1)`, which is used in a couple different ways. The purpose of `A/(x|1)` is probably obvious, but what does `(x|1)%2` do? + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2004/anonymous/README.md b/2004/anonymous/README.md index 24c356637..9b94630e2 100644 --- a/2004/anonymous/README.md +++ b/2004/anonymous/README.md @@ -4,25 +4,29 @@ The author wishes to remain anonymous\ Singapore\ + ## To build: ```sh make ``` + ## To use: ```sh ./anonymous ``` -## Try: + +### Try: ```sh ./anonymous "ash nazg durhbatuluhk, ash nazg gimbatul, \ ash nazg thrakatuluhk, agh burzhumh-ishi krimpatul." >anonymous.pgm ``` + ## Judges' remarks: Then view the output using your favourite @@ -104,6 +108,7 @@ font](https://alboin.fi/tengwar.htm). Currently, only the glyphs used in the [Ring inscription](https://www.glyphweb.com/arda/r/ringinscription.html) are included in the font. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2004/arachnid/README.md b/2004/arachnid/README.md index e307ff8fc..624bfc078 100644 --- a/2004/arachnid/README.md +++ b/2004/arachnid/README.md @@ -19,7 +19,7 @@ make ``` -## Try: +### Try: ```sh ./arachnid arachnid.info diff --git a/2004/burley/README.md b/2004/burley/README.md index 782a9ed2d..4266eb823 100644 --- a/2004/burley/README.md +++ b/2004/burley/README.md @@ -21,7 +21,7 @@ NOTE: you need to input a number first. See judges' remarks below for information on how to play. -## Try: +### Try: ```sh echo "Do or do not. There is no try." @@ -74,6 +74,7 @@ NOTE: the author talks about how it is a single statement. This might not be strictly true in 2023 for the fixes for it to work so you can look at the original file [burley.orig.c](burley.orig.c) to see what is meant. + ## Author's remarks: This program plays draw poker. What is unusual about it is that it diff --git a/2004/gavare/README.md b/2004/gavare/README.md index d1dae5ec1..29c3efee4 100644 --- a/2004/gavare/README.md +++ b/2004/gavare/README.md @@ -4,19 +4,22 @@ Anders Gavare\ Sweden\ + ## To build: ```sh make ``` + ## To use: ```sh ./gavare ``` -## Try: + +### Try: ```sh ./gavare > ioccc_ray.ppm @@ -37,7 +40,6 @@ make alt Use `gavare.r3` as you would `gavare` above. - ## Judges' remarks: For users of systems that distinguish between text and binary mode @@ -52,6 +54,7 @@ best results. The judges were able to figure out how to control position (in all 3 coordinates), size, and color (to some extent) of the balls. + ## Author's remarks: It is possible to write some kinds of programs in C without using reserved @@ -86,6 +89,7 @@ paper. Since I care for the global environment, we shouldn't waste any more laser toner, or ink, than necessary. Everyone should write C code with no reserved words, and our world will be a better place. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2004/gavin/README.md b/2004/gavin/README.md index 123eabea2..da78d29b4 100644 --- a/2004/gavin/README.md +++ b/2004/gavin/README.md @@ -11,7 +11,7 @@ make ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -30,7 +30,7 @@ For more detailed information see [2004 gavin in bugs.md](/bugs.md#2004-gavin). ``` -## Try: +### Try: To enjoy the results (on a Linux/x86 machine): diff --git a/2004/hibachi/README.md b/2004/hibachi/README.md index c6b42e2f7..0103a1d00 100644 --- a/2004/hibachi/README.md +++ b/2004/hibachi/README.md @@ -4,19 +4,22 @@ Anthony Howe\ Canada\ + ## To build: ```sh make ``` + ## To use: ```sh cd build; ./hibachi-start.sh & ``` -## Try: + +### Try: ```sh cd build; ./hibachi-start.sh & @@ -28,6 +31,7 @@ finished make sure to kill `hibachi`. NOTE: you must be in the `build` directory when running `hibachi` for this to work. + ## Judges' remarks: This entry violates the [guidelines](/2004/guidelines.txt) in so many ways! We @@ -41,6 +45,7 @@ submitted with its own [configure](build/configure) script. NOTE: the author states there is a tarball `hibachi.tgz` but this was extracted so the file does not exist here. + ## Author's remarks: ### README.TXT (Feb 2004) @@ -188,6 +193,7 @@ style](https://wiki.c2.com/?OneTrueBraceStyle). Best Interpretation of RFC 2616 Winner of The Far Too Much Free Time Award + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2004/hoyle/README.md b/2004/hoyle/README.md index 44b57664f..eb9013465 100644 --- a/2004/hoyle/README.md +++ b/2004/hoyle/README.md @@ -4,19 +4,22 @@ Jonathan Hoyle\ US\ + ## To build: ```sh make ``` + ## To use: ```sh ./hoyle point ... ``` -## Try: + +### Try: ```sh ./hoyle 10 0.5 @@ -37,6 +40,7 @@ make alt Use `hoyle.alt.c` as you would `hoyle` above. + ## Judges' remarks: This obfuscation functions at several levels. Note the clever @@ -44,6 +48,7 @@ use of use of `#define`s. The `#define do(if,else)`, for example, is delightful. The code itself contains a bunch of curves designed to throw you off axis. :-) + ## Author's remarks: This application graphs polynomials on a standard Cartesian coordinate system. @@ -73,6 +78,7 @@ Note that: will produce the same graph, since the `y-axis` is auto scaling. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2004/jdalbec/README.md b/2004/jdalbec/README.md index 56ed99901..51b3f39e8 100644 --- a/2004/jdalbec/README.md +++ b/2004/jdalbec/README.md @@ -4,19 +4,22 @@ John Dalbec\ US\ + ## To build: ```sh make ``` + ## To use: ```sh ./jdalbec number ... ``` -## Try: + +### Try: ```sh ./jdalbec 1 @@ -25,11 +28,13 @@ make ``` + ## Judges' remarks: We still aren't sure whether or not this is a useful program, but it's the first atomic fission we've seen in the IOCCC. + ## Author's remarks: It's elementary! @@ -176,6 +181,7 @@ type, a structure, a structure member, a macro parameter, and a variable.). - By naming everything after chemical elements or pairs of elements. - Because it says so in the source. ;) + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2004/kopczynski/README.md b/2004/kopczynski/README.md index 8e175b4e5..1a89cd6b0 100644 --- a/2004/kopczynski/README.md +++ b/2004/kopczynski/README.md @@ -19,7 +19,7 @@ make ``` -## Try: +### Try: ```sh ./kopczynski < kopczynski-8a diff --git a/2004/newbern/README.md b/2004/newbern/README.md index 50faeb969..204bac2ab 100644 --- a/2004/newbern/README.md +++ b/2004/newbern/README.md @@ -18,7 +18,7 @@ make ``` -## Try: +### Try: ```sh ./newbern newbern.dat "IOCCC 2004" diff --git a/2004/omoikane/README.md b/2004/omoikane/README.md index a6f473023..5095dbc39 100644 --- a/2004/omoikane/README.md +++ b/2004/omoikane/README.md @@ -4,24 +4,28 @@ Don Yang\ US\ + ## To build: ```sh make ``` + ## To use: ```sh ./omoikane infile layout outfile ``` -## Try: + +### Try: ``` ./omoikane omoikane.info omoikane.info omoikane.output ``` + ## Judges' remarks: For extra credit, spot the checksum in the source file itself. @@ -34,6 +38,7 @@ checksum; if you have to change it, you might as well change it! This program was submitted under the name `Rinia`, so the Author's Comments refer to it as such. + ## Author's remarks: **Rinia (1/14/04)** @@ -171,6 +176,7 @@ NOTE: the text above is also included as an info file but in original format, so that the checksum would match. The above was formatted in markdown for GitHub and the IOCCC website. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2004/schnitzi/README.md b/2004/schnitzi/README.md index 1f4bad763..30083d6b3 100644 --- a/2004/schnitzi/README.md +++ b/2004/schnitzi/README.md @@ -4,19 +4,22 @@ Mark Schnitzius\ Australia\ + ## To build: ```sh make ``` + ## To use: ```sh ./schnitzi ``` -## Try: + +### Try: ```sh ./schnitzi /dev/null| vi @@ -49,6 +52,7 @@ This exemplifies the meaning of Visual Editor, but we don't think that any benchmarking sites are going to use this to tout the performance of the latest hardware! + ## Author's remarks: If you've ever pasted a large chunk of text into an editor (such as @@ -172,6 +176,7 @@ is a right-click menu option on the top window bar. I would like to remind the Pixar Animation Studios that I retain royalties on this technique. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2004/sds/README.md b/2004/sds/README.md index 00fc0061a..a6695141b 100644 --- a/2004/sds/README.md +++ b/2004/sds/README.md @@ -4,6 +4,7 @@ Stephen Sykes\ Finland\ + ## To build: ```sh @@ -11,7 +12,7 @@ make ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -28,7 +29,8 @@ For more detailed information see [2004 sds in bugs.md](/bugs.md#2004-sds). ./sds ``` -## Try: + +### Try: ```sh ./sds < sds.c > encoder.c @@ -55,6 +57,7 @@ diff remarks.md README.md # notice how similar they are The generated code will very likely crash or do something else if not given a proper command line. This is not a bug but a feature. + ## Judges' remarks: Why not use the program to hide another program in the program? It @@ -67,6 +70,7 @@ horribly badly formatted emails spammers send might contain secret messages. Annoyingly, it's a little too obvious that SOMETHING has been done to a message for us to hide one in the remarks. :) + ## Author's remarks: Stenography is the term for the family of techniques used for @@ -140,6 +144,7 @@ The program (and the encoder program) should compile on any reasonable compiler. In particular, they are known to compile under GNU C. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2004/vik1/README.md b/2004/vik1/README.md index 5f14872cb..7f903f2ba 100644 --- a/2004/vik1/README.md +++ b/2004/vik1/README.md @@ -6,19 +6,22 @@ US\ \ + ## To build: ```sh make ``` + ## To use: ```sh ./vik1 [arg] ``` -## Try: + +### Try: ```sh ./vik1 @@ -29,6 +32,7 @@ make Can you figure out how to cheat? + ## Judges' remarks: Daniel Vik has presented a tour de force feature rich X11-based @@ -40,6 +44,7 @@ The author posted a video of this on YouTube: Happy touring on the road and in the code! + ## Author's remarks: ### Features @@ -145,6 +150,7 @@ that the byte order of the colors are as on my Linux PC. That is, The colors are represented by a 32 bit value where the bytes (from high to low) are { 0, RED, GREEN, BLUE }. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2004/vik2/README.md b/2004/vik2/README.md index 9fb1e1c81..c298fd5e2 100644 --- a/2004/vik2/README.md +++ b/2004/vik2/README.md @@ -5,24 +5,28 @@ US\ \ + ## To build: ```sh make ``` + ## To use: ```sh ./vik2 ``` -## Try: + +### Try: ```sh echo "Do or do not. There is no try." ``` + ## Judges' remarks: The fun thing about [CPP](https://en.wikipedia.org/wiki/C_preprocessor) abuses @@ -31,6 +35,7 @@ is that, in most cases, running the help you decipher the obfuscated code. That's assuming your preprocessor can take it at all. + ## Author's remarks: ### Introduction @@ -228,6 +233,7 @@ with 512Mb ram and a lot of disk. (*) Before cpp crashed. ``` + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2005/aidan/README.md b/2005/aidan/README.md index a05f0b23e..87ef6df6a 100644 --- a/2005/aidan/README.md +++ b/2005/aidan/README.md @@ -23,7 +23,7 @@ make where `seed` is a number. -## Try: +### Try: ```sh ./aidan < insane1.sudoku diff --git a/2005/anon/README.md b/2005/anon/README.md index 3d361593f..bd266738b 100644 --- a/2005/anon/README.md +++ b/2005/anon/README.md @@ -13,7 +13,7 @@ NOTE: if your shell does not support `stty` then see the alternate version described in the section below. -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -31,7 +31,7 @@ For more detailed information see [2005 anon in bugs.md](/bugs.md#2005-anon). ``` -## Try: +### Try: ```sh ./anon 4 4 diff --git a/2005/boutines/README.md b/2005/boutines/README.md index 94130274b..0122662e0 100644 --- a/2005/boutines/README.md +++ b/2005/boutines/README.md @@ -4,12 +4,14 @@ Francois Boutines\ Toulouse, France\ + ## To build: ```sh make ``` + ## To use: You will need an [SVG](https://www.w3.org/TR/SVG11/expanded-toc.html) viewer. @@ -22,7 +24,8 @@ The following will create an `SVG` file: ruby -e '20.times{puts "#{rand} #{rand}"}' | ./boutines > test.svg ``` -## Try: + +### Try: After running the above, use [ImageMagick](https://imagemagick.org/index.php)'s `convert` tool to convert the image to a png file: @@ -46,6 +49,7 @@ others. Can you explain the author's remark "[generated files] are not as scalable as their name suggests"? + ## Author's remarks: _In memory of my father Pierre Boutines-Vignard._ @@ -164,6 +168,7 @@ viewport and potentially every > ![Voronoi diagram of two regular pentagon vertices](Voronoi.png) + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2005/chia/README.md b/2005/chia/README.md index 8d56e2ba5..ddd081685 100644 --- a/2005/chia/README.md +++ b/2005/chia/README.md @@ -4,24 +4,28 @@ V. Chia\ Singapore\ + ## To build: ```sh make ``` + ## To use: ```sh ./chia ``` -## Try: + +### Try: ```sh echo "Do or do not. There is no try." ``` + ## Judges' remarks: Have you had your morning cup of Java? You might want a @@ -29,6 +33,7 @@ second cup before parsing this entry. And give your C pre-processor a triple shot as it tries to handle parameters for "stringification". + ## Author's remarks: Two things inspired this entry. First, there were the C programs which were @@ -64,6 +69,7 @@ when they see macro parameters that don't look like C tokens. [Visual Basic]: https://en.wikipedia.org/wiki/Visual_Basic_(classic) [Java]: https://en.wikipedia.org/wiki/Java_(programming_language) + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2005/giljade/README.md b/2005/giljade/README.md index f3cef32cc..1fdc81077 100644 --- a/2005/giljade/README.md +++ b/2005/giljade/README.md @@ -23,7 +23,7 @@ version but it's a complicated one. See also the [bugs.md](/bugs.md) file for more information. -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -41,7 +41,7 @@ For more detailed information see [2005 giljade in bugs.md](/bugs.md#2005-giljad ``` -## Try: +### Try: ```sh ./giljade > out diff --git a/2005/jetro/README.md b/2005/jetro/README.md index 20f39bb1e..b2d6eb356 100644 --- a/2005/jetro/README.md +++ b/2005/jetro/README.md @@ -4,6 +4,7 @@ Jetro Lauha\ Finland\ + ## To build: This entry requires SDL to be installed. @@ -24,12 +25,14 @@ make ./jetro ``` -## Try: + +### Try: ```sh echo "Do or do not. There is no try." ``` + ## Judges' remarks: We have seen entries with SDL graphics in the past, now it's time for SDL @@ -39,6 +42,7 @@ into the SDL documentation. Can you figure out how the notes are encoded and program a different melody? + ## Author's remarks: To compile the entry you need SDL library, which is used only for audio @@ -47,6 +51,7 @@ plays 22KHz 16 bit mono music with a small softsynth. When the music plays, you can stop the application by pressing enter, as the code will just wait with one call to getchar() before it quits. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2005/klausler/README.md b/2005/klausler/README.md index 116b03c87..3d21cf672 100644 --- a/2005/klausler/README.md +++ b/2005/klausler/README.md @@ -4,24 +4,28 @@ Peter Klausler\ US\ + ## To build: ```sh make ``` + ## To use: ```sh ./klausler arg1 arg2 | head ``` -## Try: + +### Try: ```sh ./klausler peter klausler | head ``` + ## Judges' remarks: To reduce the size of the source, include other people's data. @@ -32,6 +36,7 @@ In other words: make use of other words! :-) Rules might have to be changed! + ## Author's remarks: A useful tool to help one appear extra smart and witty when @@ -63,6 +68,7 @@ ask. Upon reviewing the program after its unexpected honor, I guess that it's remarkable only for its complete lack of macros, sneaky naming, `main()` recursion, or other tricks. Enjoy! + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2005/mikeash/README.md b/2005/mikeash/README.md index 104cf0402..7cbb4b3c6 100644 --- a/2005/mikeash/README.md +++ b/2005/mikeash/README.md @@ -5,19 +5,22 @@ US\ mike@mikeash.com\ + ## To build: ```sh make ``` + ## To use: ```sh ./mikeash ``` -## Try: + +### Try: ```sh ./mikeash < mikeash.c @@ -27,6 +30,7 @@ make NOTE: the author stated that they tested this under i386 machines but this works under 64-bit (x86_64, arm64) machines too. + ## Judges' remarks: Having problems speaking code? Do you [LISP][]? Parenthetically @@ -37,6 +41,7 @@ John McCarthy might not have imagined it quite like this! :-) [LISP]: https://en.wikipedia.org/wiki/Lisp_(programming_language) + ## Author's remarks: This program is a self-reproducing program, which is on the IOCCC's list @@ -155,6 +160,7 @@ hardcoding various character constants. Other than this requirement, it should run anywhere there's a conforming C99 compiler and a standard C library. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2005/mynx/README.md b/2005/mynx/README.md index 9e597b146..390dff3bd 100644 --- a/2005/mynx/README.md +++ b/2005/mynx/README.md @@ -12,7 +12,7 @@ make ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -33,7 +33,7 @@ You can specify a port by appending to the domain `:port`. See notes below on the issue of https. -## Try: +### Try: ```sh ./mynx http://www.textfiles.com diff --git a/2005/persano/README.md b/2005/persano/README.md index 72af52089..1aa530841 100644 --- a/2005/persano/README.md +++ b/2005/persano/README.md @@ -4,19 +4,22 @@ Mauro Persano\ Brazil\ + ## To build: ```sh make ``` + ## To use: ```sh ./persano p q [num frames] ``` -## Try: + +### Try: ```sh ./persano 3 16 > knot3-16.gif @@ -28,6 +31,7 @@ need to use [gifsicle](https://www.lcdf.org/gifsicle/) - a great tool to manipulate animated GIFs - to slow down the animation and to compress the GIFs generated by the entry). + ## Judges' remarks: If your system is one of those that distinguish between text and binary @@ -43,8 +47,8 @@ At the time of judging, the approximation of [π](https://en.wikipedia.org/wiki/Pi) used in the program could not be found on . -## Author's remarks: +## Author's remarks: **knot** writes animated GIF images of rendered [torus knots](https://en.wikipedia.org/wiki/Torus_knot) to standard output. @@ -135,6 +139,7 @@ was not implemented in order to avoid the Unisys patent can no longer be used. [4] ;) + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2005/sykes/README.md b/2005/sykes/README.md index 85858548f..9180bf5cd 100644 --- a/2005/sykes/README.md +++ b/2005/sykes/README.md @@ -4,19 +4,22 @@ Stephen Sykes\ \ + ## To build: ```sh make ``` + ## To use: ```sh ./sykes binary_file ``` -## Try: + +### Try: ```sh ./sykes pet.rom @@ -32,6 +35,7 @@ Also try: for some good [chess](https://en.wikipedia.org/wiki/Chess) fun. + ## Judges' remarks: For those who fondly remember their first @@ -62,6 +66,7 @@ dd bs=2k count=1 if=/dev/zero of=nullfill.bin For your convenience, we have added the above mentioned files to this entry directory. They are used to form the `pet.rom` file. + ## Author's remarks: This program is not only a complete [Motorola 6502 @@ -305,6 +310,7 @@ What does this do? \ Have fun! + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2005/timwi/README.md b/2005/timwi/README.md index 61acfc82b..85b234757 100644 --- a/2005/timwi/README.md +++ b/2005/timwi/README.md @@ -4,24 +4,28 @@ Arne "Timwi" Heizmann\ Germany\ + ## To build: ```sh make ``` + ## To use: ```sh ./timwi < bf_program ``` -## Try: + +### Try: ```sh (echo "20 : ,-->+.>+.<<[>[>>+>+<<<-]>[>>+>+<<<-]>"; echo "[<+>-]>[<<<+>>>-]>[-]<<<<.<-]") | ./timwi ``` + ## Judges' remarks: Unlike most [BF](https://en.wikipedia.org/wiki/Brainfuck) interpreters that we @@ -37,6 +41,7 @@ Why? [quines]: https://en.wikipedia.org/wiki/Quine_(computing) + ## Author's remarks: This is an interpreter for the programming language @@ -88,6 +93,7 @@ execution immediately and only read program instructions as they are needed. Yet there is no global variable storing how far it has read! Perhaps the hardest thing to figure out is how it finds the matching square brackets. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2005/toledo/README.md b/2005/toledo/README.md index c24793f32..7f63ffaac 100644 --- a/2005/toledo/README.md +++ b/2005/toledo/README.md @@ -5,19 +5,22 @@ Familia Toledo\ Mexico\ + ## To build: ```sh make ``` + ## To use: ```sh ./toledo [a ...] ``` -## Try: + +### Try: ```sh ./toledo a @@ -37,6 +40,7 @@ make alt Use `toledo2` and `toledo3` as you would `toledo` above. + ## Judges' remarks: Challenge yourself with your ability to look 5, 6 or more moves ahead. @@ -44,6 +48,7 @@ Challenge your knowledge of C operator precedence. The following is the move analysis via recursion while it executes moves. All while playing by the rules of C and Chess within a single function! + ## Author's remarks: ### What does this program @@ -145,6 +150,7 @@ and compiles faster... but I'm still not seeing the difference. * Uses only one string, very easy to [i18n](https://en.wikipedia.org/wiki/Internationalization_and_localization) ;) + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2005/vik/README.md b/2005/vik/README.md index 06cbf106b..69bb6f582 100644 --- a/2005/vik/README.md +++ b/2005/vik/README.md @@ -5,30 +5,35 @@ US\ \ + ## To build: ```sh make ``` + ## To use: ```sh ./vik [file.map] ``` -## Try: + +### Try: ```sh ./vik maze.map ``` + ## Judges' remarks: An amazing use of the X libraries with twisty code passages, all different. One risks running in code path circles as `main()` is called again and again. Be sure to pay attention to commas! :-) + ## Author's remarks: This entry is a [Wolfenstein](https://en.wikipedia.org/wiki/Wolfenstein) style @@ -146,6 +151,7 @@ The program does not run that smooth under with Cygwin and it can easily be solved by increasing the priority of the application a little bit. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2005/vince/README.md b/2005/vince/README.md index af64d1de8..104549f6b 100644 --- a/2005/vince/README.md +++ b/2005/vince/README.md @@ -5,6 +5,7 @@ US\ \ + ## To build: Before building, make sure that you have the OpenGL development libraries @@ -14,6 +15,7 @@ installed. make ``` + ## To use: ```sh @@ -23,7 +25,8 @@ make Under macOS run from within an console tab (whether xterm, the default or another) while the X11 server is running. -## Try: + +### Try: ```sh echo "Do or do not. There is no try." @@ -42,6 +45,7 @@ make alt Use `vince.alt` as you would `vince` above. + ## Judges' remarks: This beauteous entry makes use of visual `{}`s and whitespace to instruct the @@ -53,6 +57,7 @@ NOTE: when hitting space bar make sure that the program window is in focus! Challenge: Try modifying the texture to something of your own design. + ## Author's remarks: ### ABUSE OF RULES @@ -118,6 +123,7 @@ problem. - 3 = Can't open 16bpp visual. - 4 = can't open source file. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2006/birken/README.md b/2006/birken/README.md index ca0329637..a78d4971e 100644 --- a/2006/birken/README.md +++ b/2006/birken/README.md @@ -19,7 +19,7 @@ make ``` -## Try: +### Try: ```sh ./birken < counter.tofu diff --git a/2006/borsanyi/README.md b/2006/borsanyi/README.md index 30439b0a2..f14800ce0 100644 --- a/2006/borsanyi/README.md +++ b/2006/borsanyi/README.md @@ -19,7 +19,7 @@ make ``` -## Try: +### Try: ```sh ./borsanyi ioccc@example.com > example.gif diff --git a/2006/grothe/README.md b/2006/grothe/README.md index 66a83aed7..ae2b8c90c 100644 --- a/2006/grothe/README.md +++ b/2006/grothe/README.md @@ -3,19 +3,22 @@ Aaron Grothe\ US + ## To build: ```sh make ``` + ## To use: ```sh ./grothe carrier_freq pixelclock horizontal_total < some_input.txt ``` -## Try: + +### Try: ```sh ./grothe 65000000 10000000 1344 < twinkle.txt @@ -32,6 +35,7 @@ There are other text files you may wish to try: ./grothe 65000000 10000000 1344 < test.txt ``` + ## Judges' remarks: Most of the time, interference is annoying. This entry is the diff --git a/2006/hamre/README.md b/2006/hamre/README.md index 724255dcd..23e89f18d 100644 --- a/2006/hamre/README.md +++ b/2006/hamre/README.md @@ -3,6 +3,7 @@ Steinar Hamre\ Norway + ## To build: ```sh @@ -16,12 +17,14 @@ make ./hamre math_expression_string ``` -## Try: + +### Try: ```sh ./hamre '-1+4/3*(2+1/(3/2*(7/2-7/3+1/6)))/2' ``` + ## Judges' remarks: An irrationally coded source presents rational things! @@ -32,6 +35,7 @@ of supporting a new operator by way of an existing macro in the source. And can you determine which macro this is and understand the purpose of its arguments? + ## Author's remarks: This is a calculator for [rational @@ -71,6 +75,7 @@ help hide most of the uses of these numbers away. All macros and variables are easy-to-remember single character abbreviations, from some language, meaningful to the purpose(s) of the macro, I hope. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2006/meyer/README.md b/2006/meyer/README.md index 2c337f9a6..ff7761524 100644 --- a/2006/meyer/README.md +++ b/2006/meyer/README.md @@ -3,19 +3,22 @@ Raphael Meyer\ US + ## To build: ```sh make ``` + ## To use: ```sh ./meyer ``` -## Try: + +### Try: ```sh ./meyer @@ -30,6 +33,7 @@ a 0 1 NOTE: if you do not input three different 'words' it will block. You can input more text to fulfil the program's requirements. + ## Judges' remarks: This entry turns a newspaper solitaire puzzle into a competition @@ -37,6 +41,7 @@ with the computer to be the last one moving. The object of this [source code](meyer.c) is to determine the object of this [source code](meyer.c)! :-) + ## Author's remarks: I wanted submit a fully object-oriented entry to show that @@ -131,6 +136,7 @@ The game can be aborted with `q`. The one who can do the last move wins the game. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2006/monge/README.md b/2006/monge/README.md index 6876b3646..4c0acf579 100644 --- a/2006/monge/README.md +++ b/2006/monge/README.md @@ -14,7 +14,7 @@ make ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -32,7 +32,7 @@ For more detailed information see [2006 monge in bugs.md](/bugs.md#2006-monge). ``` -## Try: +### Try: ```sh ./monge "z = 0" "z = z*z*z + c; Abs2(z) < 4" diff --git a/2006/night/README.md b/2006/night/README.md index 7bdc22f3b..3edb1667c 100644 --- a/2006/night/README.md +++ b/2006/night/README.md @@ -22,7 +22,7 @@ There is an alternate version that supports arrow keys. See the alternate code section below. -## Try: +### Try: ```sh echo "Do or do not. There is no try." diff --git a/2006/sloane/README.md b/2006/sloane/README.md index b3bf31300..8cf7187d2 100644 --- a/2006/sloane/README.md +++ b/2006/sloane/README.md @@ -20,7 +20,8 @@ make alt To see why we recommend the alternate version instead of the original version, see the [original code](#original-code) section. -## Try: + +### Try: This alternate version, which we recommend that you use in order to see what is happening with modern systems, and to not flash too quickly, which can be @@ -41,6 +42,7 @@ make CDEFINE="-DS=0" clobber alt ./sloane.alt ``` + ## Original code: Should you wish to see the original without having to mess with the compiler diff --git a/2006/stewart/README.md b/2006/stewart/README.md index e1a46c56e..9d9dd4248 100644 --- a/2006/stewart/README.md +++ b/2006/stewart/README.md @@ -3,6 +3,7 @@ Thomas Stewart\ US + ## To build: ```sh @@ -21,7 +22,8 @@ NOTE: you cannot specify a different width from height; it's one number. NOTE: `convert(1)` belongs to [ImageMagick](https://imagemagick.org/index.php). -## Try: + +### Try: ```sh ./stewart 400 1000000 maze > maze.xbm\ @@ -44,6 +46,7 @@ The selection of input files makes this one endlessly fun to play with. Many image viewers will be able to read the results, as will a reasonably experienced user who can parse formats in their mind. :-) + ## Author's remarks: ### Execution @@ -193,6 +196,7 @@ Using `xbm` as the output format. This might confuse someone who doesn't have an X background. It happens to be easy but is probably a very bad choice from a file size standpoint. 1024x1024 image is 641k in size. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2006/sykes1/README.md b/2006/sykes1/README.md index 7a8952cc8..5e592b238 100644 --- a/2006/sykes1/README.md +++ b/2006/sykes1/README.md @@ -4,12 +4,14 @@ Stephen Sykes\ Finland\ + ## To build: ```sh make ``` + ## To use: ```sh @@ -18,7 +20,8 @@ make Next point your browser to the file: `sykes1.html`. -## Try: + +### Try: ```sh ./sykes1 10 @@ -64,6 +67,7 @@ an negative number argument, and why. See the author's remarks for how to make your own shapes as well. + ## Author's remarks: This cube shaped program solves the fiendishly difficult "Bedlam Cube". @@ -246,6 +250,7 @@ advantage - at least I don't violate any of those old Unisys patents! The pieces aren't really those colors. Unless you make your own. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2006/sykes2/README.md b/2006/sykes2/README.md index 5981ea233..c558885b2 100644 --- a/2006/sykes2/README.md +++ b/2006/sykes2/README.md @@ -4,19 +4,22 @@ Stephen Sykes\ Finland\ + ## To build: ```sh make ``` + ## To use: ```sh ./sykes2 ``` -## Try: + +### Try: ```sh ./sykes2.sh @@ -31,6 +34,7 @@ As they say, "Lather, rinse, repeat"! :-) If you have the time :-), figure out how this small 1-line entry works! + ## Author's remarks: At 130 characters of C code (without the newline at the end), this @@ -54,6 +58,7 @@ easily be declared as int at the expense of 4 more characters. I'm not sure of the effects on a hard disk of rewriting the same file multiple times per second for a long time. Run at your own risk! + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2006/toledo1/README.md b/2006/toledo1/README.md index 1e76ceaaf..0ddd91664 100644 --- a/2006/toledo1/README.md +++ b/2006/toledo1/README.md @@ -5,12 +5,14 @@ Familia Toledo\ Mexico\ + ## To build: ```sh make ``` + ## To use: ```sh @@ -20,7 +22,7 @@ make where `[0-9][0-9]` is a two digit number. -## Try: +### Try: ```sh ./toledo1 00 @@ -28,6 +30,7 @@ where `[0-9][0-9]` is a two digit number. ./toledo1 99 ``` + ## Judges' remarks: For most of the arguments (e.g. those above) the resulting path @@ -36,6 +39,7 @@ is not circular, but at least one starting point yields a circular path. Why do some of the "illegal" starting points work more or less as could be expected, and some dump core? + ## Author's remarks: Can you place a knight on a chess board and make it @@ -56,6 +60,7 @@ It will print move order. The algorithm is so simple that you can read it on the source code. At the first glance it can appear checkered. Nevertheless, don't be dismayed, jar, jar. :-) + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2006/toledo2/README.md b/2006/toledo2/README.md index 233fc2e2d..cbc180a6e 100644 --- a/2006/toledo2/README.md +++ b/2006/toledo2/README.md @@ -17,7 +17,7 @@ for DOS/Windows. This cannot be tested by us, not even to compile, but it appear that it should be fine, after the proper header files were added. -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -41,7 +41,7 @@ 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? :-)' -## Try: +### Try: ```sh ./toledo2 @@ -76,6 +76,7 @@ The author noted that for PC/DOS you will have to add `ANSI.SYS` to your Use `toledeo2.alt` as you would `toledo2` above. + ## Judges' remarks: We're impressed! Last year, it was a diff --git a/2006/toledo3/README.md b/2006/toledo3/README.md index aee9ac3bb..7ef6b2075 100644 --- a/2006/toledo3/README.md +++ b/2006/toledo3/README.md @@ -20,7 +20,7 @@ make ``` -## Try: +### Try: ```sh ./toledo3 1 diff --git a/2011/akari/README.md b/2011/akari/README.md index 65e2b2ac7..a2b91827b 100644 --- a/2011/akari/README.md +++ b/2011/akari/README.md @@ -4,19 +4,22 @@ Don Yang\ \ + ## 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. diff --git a/2011/blakely/README.md b/2011/blakely/README.md index f76ef7ec2..73954d22d 100644 --- a/2011/blakely/README.md +++ b/2011/blakely/README.md @@ -4,12 +4,14 @@ Philip Blakely\ Cambridge, UK\ + ## 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. diff --git a/2011/borsanyi/README.md b/2011/borsanyi/README.md index bdbb33b8b..c25f7e95e 100644 --- a/2011/borsanyi/README.md +++ b/2011/borsanyi/README.md @@ -4,19 +4,22 @@ Szabolcs Borsanyi\ Germany\ + ## 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. diff --git a/2011/dlowe/README.md b/2011/dlowe/README.md index 0e76214f1..56324f66f 100644 --- a/2011/dlowe/README.md +++ b/2011/dlowe/README.md @@ -5,6 +5,7 @@ US\ \ + ## 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. diff --git a/2011/eastman/README.md b/2011/eastman/README.md index e89b88e9a..d065799e5 100644 --- a/2011/eastman/README.md +++ b/2011/eastman/README.md @@ -18,7 +18,7 @@ make ``` -## Try: +### Try: Quit the program. Resize your terminal window. Run it again. diff --git a/2011/fredriksson/README.md b/2011/fredriksson/README.md index 2b52fe821..e5b433443 100644 --- a/2011/fredriksson/README.md +++ b/2011/fredriksson/README.md @@ -3,19 +3,22 @@ Kimmo Fredriksson\ + ## 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. diff --git a/2011/goren/README.md b/2011/goren/README.md index 02f24242a..525f62bd8 100644 --- a/2011/goren/README.md +++ b/2011/goren/README.md @@ -18,7 +18,7 @@ echo "some text" | ./goren ``` -## Try: +### Try: ```sh echo "Hello, world!" | ./goren diff --git a/2011/hamaji/README.md b/2011/hamaji/README.md index 5e34593b9..41b13fbd7 100644 --- a/2011/hamaji/README.md +++ b/2011/hamaji/README.md @@ -3,19 +3,22 @@ Shinichiro Hamaji\ + ## 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 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. diff --git a/2011/hou/README.md b/2011/hou/README.md index 322cb3d7d..3335c35a1 100644 --- a/2011/hou/README.md +++ b/2011/hou/README.md @@ -3,19 +3,22 @@ Hou Qiming\ + ## 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. diff --git a/2011/konno/README.md b/2011/konno/README.md index 6ddc94714..74fa72fd8 100644 --- a/2011/konno/README.md +++ b/2011/konno/README.md @@ -4,19 +4,22 @@ Taketo Konno\ Japan\ + ## 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. diff --git a/2011/richards/README.md b/2011/richards/README.md index e7358d152..88b231838 100644 --- a/2011/richards/README.md +++ b/2011/richards/README.md @@ -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 diff --git a/2011/toledo/README.md b/2011/toledo/README.md index 7f4d04c75..5418a84a0 100644 --- a/2011/toledo/README.md +++ b/2011/toledo/README.md @@ -5,12 +5,14 @@ Mexico\ \ + ## 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. diff --git a/2011/vik/README.md b/2011/vik/README.md index 00f717f4e..4a6cdcba8 100644 --- a/2011/vik/README.md +++ b/2011/vik/README.md @@ -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 - diff --git a/2011/zucker/README.md b/2011/zucker/README.md index 513fd8762..2b6db83f7 100644 --- a/2011/zucker/README.md +++ b/2011/zucker/README.md @@ -4,19 +4,22 @@ Matt Zucker\ \ + ## 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. diff --git a/2012/blakely/README.md b/2012/blakely/README.md index 94dccf3d3..08dd8e527 100644 --- a/2012/blakely/README.md +++ b/2012/blakely/README.md @@ -4,19 +4,22 @@ Philip Blakely\ UK\ + ## To build: ```sh make ``` + ## To use: ```sh ./blakely "RPN formula" resolution > output.gif ``` -## Try: + +### Try: ```sh ./blakely "xx*yy*+" 64 > paraboloid.gif @@ -26,6 +29,7 @@ make time ./blakely 0 250 > flat.gif ``` + ## Judges' remarks: Several IOCCC themes ([RPN @@ -38,6 +42,7 @@ The checkerboard pattern in the output can be broken. Could you figure out how? Larger GIF files confuse some image viewers. + ## Author's remarks: ### Remarks @@ -144,6 +149,7 @@ cos](https://en.wikipedia.org/wiki/Sine_and_cosine) are not used. (Note that the author may or may not be able to answer all of the above questions.) + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2012/deckmyn/README.md b/2012/deckmyn/README.md index 9c8ea94b6..68fa943d4 100644 --- a/2012/deckmyn/README.md +++ b/2012/deckmyn/README.md @@ -3,12 +3,14 @@ Alex Deckmyn\ + ## To build: ```sh make ``` + ## To use: A shell interpreter with proper backtick interpolation is required. @@ -17,12 +19,14 @@ A shell interpreter with proper backtick interpolation is required. ./deckmyn "`cat deckmyn.c`" "`cat musicfile.txt`" > sheetmusic.pbm ``` -## Try: + +### Try: ```sh ./deckmyn "`cat deckmyn.c`" "`cat example_greensleeves`" > greensleeves.pbm ``` + ## Judges' remarks: The C of this entry is definitely sharp. The program cleverly uses its own @@ -37,6 +41,7 @@ Shell](https://en.wikipedia.org/wiki/C_shell). Please use [Bourne-family shells](https://en.wikipedia.org/wiki/Bourne_shell) to run this entry. + ## Author's remarks: ### Example use @@ -138,6 +143,7 @@ maintaining a diversified code base. It is therefore not... Oh all right. character nested conditional expression. - `printf()` is also used for its return value. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2012/dlowe/README.md b/2012/dlowe/README.md index 847e9ea42..613637dfa 100644 --- a/2012/dlowe/README.md +++ b/2012/dlowe/README.md @@ -5,6 +5,7 @@ US \ + ## To build: ```sh @@ -16,13 +17,15 @@ compile. macOS users running Mountain Lion and later will need to download and install [XQuartz](https://www.xquartz.org) in order to compile and run this entry. + ## To use: ```sh ./dlowe ``` -## Try: + +### Try: ```sh ./dlowe @@ -32,6 +35,7 @@ Watch for a while if you like, then press a key within the window. Use up and down keys to escape death. + ## Judges' remarks: The judges lose playing this game. This entry wins! @@ -107,6 +111,7 @@ precedence. Lots of magic numbers, abuse of the relationships between magic numbers, and abuse of the arithmetic properties of magic numbers. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2012/endoh1/README.md b/2012/endoh1/README.md index 8a252c879..b1be116ff 100644 --- a/2012/endoh1/README.md +++ b/2012/endoh1/README.md @@ -5,19 +5,22 @@ Yusuke Endoh\ \ Mastodon: [@mame@ruby.social](https://ruby.social/@mame) + ## To build: ```sh make ``` + ## To use: ```sh ./endoh1 < configuration.txt ``` -## Try: + +### Try: ```sh ./endoh1 < endoh1.c @@ -45,6 +48,7 @@ make alt Use `endoh1.alt` as you would `endoh1` above. + ## Judges' remarks: Let's play [Jeopardy!](https://en.wikipedia.org/wiki/Jeopardy!) @@ -60,6 +64,7 @@ happy to experiment with. One configuration file was inspired by an [XKCD what if? entry](http://whatif.xkcd.com/6/). + ## Author's remarks: ### Synopsis @@ -200,6 +205,7 @@ after the contest. The judges and HAMANO Tsukasa (The silver medalist at this IOCCC) kindly provided many configuration files. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2012/endoh2/README.md b/2012/endoh2/README.md index 59b9e29ec..65cebe196 100644 --- a/2012/endoh2/README.md +++ b/2012/endoh2/README.md @@ -5,12 +5,14 @@ Yusuke Endoh\ \ Mastodon: [@mame@ruby.social](https://ruby.social/@mame) + ## To build: ```sh make ``` + ## To use: ```sh @@ -29,12 +31,14 @@ gcc -o e e.c ... -## Try: + +### Try: ```sh ./everything.sh ``` + ## Judges' remarks: A @@ -44,6 +48,7 @@ art](https://en.wikipedia.org/wiki/ASCII_art) with a compressed font in it; what else to wish for in this program? [Virtual machine](https://en.wikipedia.org/wiki/Virtual_machine) emulation? + ## Author's remarks: Yeah, "Again". Sorry. But I don't feel guilty or uncomfortable. @@ -150,6 +155,7 @@ You can do `make everything` for the process (with no `cat`). Note: The executable may return a failure (non-zero) exit status unless `-std=c99` option is given. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2012/grothe/README.md b/2012/grothe/README.md index 0ae115ed1..5c3bce32e 100644 --- a/2012/grothe/README.md +++ b/2012/grothe/README.md @@ -7,12 +7,14 @@ US\ David Madore\ + ## To build: ```sh make ``` + ## To use: To create a shared secret shared among `M` people with `N+1` needed to reconstruct: @@ -29,7 +31,8 @@ more shared files with their proper numbers): ./grothe I-sharedI J-sharedJ K-sharedK ... +reconstructed ``` -## Try: + +### Try: ```sh ./grothe -grothe.c 1+grothe.c.1 2+grothe.c.2 @@ -39,6 +42,7 @@ more shared files with their proper numbers): ./grothe 1-cookie_piece1.dat 2-cookie_piece2.dat 4-cookie_piece4.dat 4+cookie_recipe_restore.txt ``` + ## Judges' remarks: Also known as 'Best abuse of the judging process'. @@ -56,6 +60,7 @@ The judges also took some liberty obfuscating this entry a little more. How does this entry work? The only place multiplication is used is to perform the `atoi()` conversion. + ## Author's remarks: ### Description @@ -139,6 +144,7 @@ need to be so trying to figure it out can be a bit tough. * David Madore's implementation of Shamir's Secret Sharing - * Steve's Recipe Database - source for the $25k Cookie Recipe - + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2012/hamano/README.md b/2012/hamano/README.md index 926652242..f73051459 100644 --- a/2012/hamano/README.md +++ b/2012/hamano/README.md @@ -3,19 +3,22 @@ Tsukasa Hamano\ + ## To build: ```sh make ``` + ## To use: ```sh ./hamano < textfile > output.pdf ``` -## Try: + +### Try: ```sh ./hamano < README.md > hint.pdf @@ -43,6 +46,7 @@ cc -Wno-implicit-function-declaration -xc hello.pdf -o hello2 ./hello3 ``` + ## Judges' remarks: This entry treads into a new territory for IOCCC - generating PDF files. @@ -71,6 +75,7 @@ Don't forget to take a look at the generated PDF. Perhaps you might even want to compile the output with a C compiler. When you run it, what does it output? + ## Author's remarks: This program obfuscate text file into PDF file with [Dancing men @@ -92,6 +97,7 @@ PDF Readers: This program is obfuscated by using classical methods. But can you find the embedded font in the fragmented glyph? + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2012/hou/README.md b/2012/hou/README.md index 86e162f46..fa013b14e 100644 --- a/2012/hou/README.md +++ b/2012/hou/README.md @@ -4,19 +4,22 @@ Qiming Hou\ \ + ## To build: ```sh make ``` + ## To use: ```sh ./hou syntax-file file-to-process ``` -## Try: + +### Try: ```sh less hou.c @@ -40,6 +43,7 @@ hou html.txt hou.c >> hou.htm start hou.htm ``` + ## Judges' remarks: What a versatile entry! It can be used to check the size of IOCCC entries *and* @@ -47,6 +51,7 @@ to publish them as HTML. For extra credit: what is the meaning of the number `2321237`? + ## Author's remarks: ### Disclaimer @@ -136,6 +141,7 @@ As an extra tweak, the text message actually does something useful. Remove the [2][Regular Expression Matching Can Be Simple And Fast (but is slow in Java, Perl, PHP, Python, Ruby, ...)](http://swtch.com/~rsc/regexp/regexp1.html) + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2012/kang/README.md b/2012/kang/README.md index e4823c0c2..fa6693d97 100644 --- a/2012/kang/README.md +++ b/2012/kang/README.md @@ -14,6 +14,7 @@ make There is alternate code which fixes some German at the expense of other German. See [Alternate code](#alternate-code) below. + ## To use: ```sh @@ -21,7 +22,7 @@ echo "full spelling of an English cardinal numeral less than a quadrillion" | ./ ``` -## Try: +### Try: ```sh ./try.sh # try various languages @@ -96,6 +97,7 @@ echo hundr|./kang does not report 100, instead printing 0? + ## Author's remarks: ### Synopsis diff --git a/2012/konno/README.md b/2012/konno/README.md index 697fdae12..f3cd3f513 100644 --- a/2012/konno/README.md +++ b/2012/konno/README.md @@ -4,12 +4,14 @@ Taketo Konno\ Japan\ + ## To build: ```sh make ``` + ## To use: ```sh @@ -18,7 +20,8 @@ make NOTE: N is an integer from 0 to 255. -## Try: + +### Try: ```sh ./konno 30 @@ -37,6 +40,7 @@ make alt Use `konno.alt` as you would `konno` above. + ## Judges' remarks: This entry is a good one-liner to analyze completely. @@ -44,6 +48,7 @@ This entry is a good one-liner to analyze completely. For extra credit, what are the minimal changes to convert it to 64-bit integers so that it could print 32 lines? + ## Author's remarks: ### Remarks @@ -82,6 +87,7 @@ operation. What is the operation doing? This program assumes that the size of `int` is 4. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2012/omoikane/README.md b/2012/omoikane/README.md index b84040550..cc8cf63df 100644 --- a/2012/omoikane/README.md +++ b/2012/omoikane/README.md @@ -4,12 +4,14 @@ Don Yang\ \ + ## To build: ```sh make ``` + ## To use: ```sh @@ -23,7 +25,8 @@ gcc output.c -o output ./output > regenerated.bin ``` -## Try: + +### Try: ```sh echo "A quick brown fox jumps over the lazy dog" | ./nyaruko > output.c @@ -34,11 +37,13 @@ cc -o output output.c ./output ``` + ## Judges' remarks: The judges have nothing to add that has not already been written about in the [spoiler.html](spoiler.html) (requires JavaScript) file! :-) + ## Author's remarks: ### Usage @@ -146,6 +151,7 @@ default, this means `Nyaruko` may not faithfully encode files on MingW. blank state to an obfuscated program, gzipped to fit under 1MB. Requires JavaScript. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2012/tromp/README.md b/2012/tromp/README.md index 8238252ef..0f9827ee3 100644 --- a/2012/tromp/README.md +++ b/2012/tromp/README.md @@ -31,7 +31,7 @@ cat binary-prog.Blc data | ./tromp ``` -## Try: +### Try: ```sh (cat hilbert.Blc; echo -n 1234) | ./tromp @@ -39,6 +39,7 @@ cat binary-prog.Blc data | ./tromp cat primes.blc | ./tromp -b | ./primes.pl ``` + ## Judges' remarks: The judges dare to say that the data files this entry is processing diff --git a/2012/vik/README.md b/2012/vik/README.md index edb59fdfa..d548acdb4 100644 --- a/2012/vik/README.md +++ b/2012/vik/README.md @@ -14,7 +14,7 @@ make This entry requires [Zlib](https://www.zlib.net). -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -68,7 +68,7 @@ pixel formats 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 e ioccc.png chocolate.png > chocolate-in-ioccc.png diff --git a/2012/zeitak/README.md b/2012/zeitak/README.md index df83e090a..36245318d 100644 --- a/2012/zeitak/README.md +++ b/2012/zeitak/README.md @@ -3,12 +3,14 @@ Adar Zeitak\ + ## To build: ```sh make ``` + ## To use: ```sh @@ -18,7 +20,8 @@ make where `file.c` is the file to be checked for nesting errors. For example, you may try [incorrect.c](incorrect.c) and the program itself. -## Try: + +### Try: ```sh ./zeitak < zeitak.c @@ -43,6 +46,7 @@ make alt Use `zeitak.alt` as you would `zeitak` above. + ## Judges' remarks: This is an extremely subtle and twisted piece of Gold award winning code! @@ -53,7 +57,8 @@ At one point we spent minutes](https://web.archive.org/web/20130925190722/https://twitter.com/ioccc/status/252162898800033792) just to understand 18 key characters of this code. -## Author's remarks + +## Author's remarks: ### Nesting Errors Detector @@ -123,6 +128,7 @@ only function calls, typecasts, array lookups and pointer operators. - Windows 7 32-bit with GCC - Windows 7 32-bit with OpenWatcom + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2013/birken/README.md b/2013/birken/README.md index 9d3174bde..afb056685 100644 --- a/2013/birken/README.md +++ b/2013/birken/README.md @@ -11,6 +11,7 @@ Michael Birken\ make alt ``` + ## To use: To see why we recommend the alternate version instead of the original version, @@ -23,7 +24,8 @@ see the [original code](#original-code) section. To see why we recommend the alternate version instead of the original version, see the [original code](#original-code) section. -## Try: + +### Try: This alternate version, which we recommend that you use in order to see what is happening with modern systems, and to not flash colours too quickly, which can @@ -51,6 +53,7 @@ If you wish to speed it up 200% you can use instead `-DZ=3750`. Doing this you might find the right value to your liking; use ctrl-c to terminate the program early. + ## Original code: Should you wish to see the original without having to mess with the compiler @@ -70,6 +73,7 @@ BIRKEN=birken ./try.sh PLEASE be careful if you are sensitive to flashing colours! + ## Judges' remarks: This program also wins the "Most amusing abuse of the iocccsize tool" award; although not the diff --git a/2013/cable1/README.md b/2013/cable1/README.md index 23431f307..26562ca08 100644 --- a/2013/cable1/README.md +++ b/2013/cable1/README.md @@ -3,19 +3,22 @@ Adrian Cable\ + ## To build: ```sh make ``` + ## To use: ```sh ./cable1 name group1 group2 ``` -## Try: + +### Try: ```sh ./cable1 obama republican democrat @@ -25,6 +28,7 @@ make ./cable1 lincoln republican democrat ``` + ## Judges' remarks: Partisan may be defined as a strong supporter of a cause, party or person. @@ -86,6 +90,7 @@ End of important 2023 update to this historic note. So how does a one line C source know so much? Hint: it doesn't. + ## Author's remarks: ### Presidents of the United States of America! @@ -123,6 +128,7 @@ table? `clang` warns about a missing type specifier for `main()`, and that implicit function declarations are invalid in C99 (but still accepts them). + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2013/cable2/README.md b/2013/cable2/README.md index 2ebe3e924..8743474f9 100644 --- a/2013/cable2/README.md +++ b/2013/cable2/README.md @@ -3,19 +3,22 @@ Adrian Cable\ \ + ## To build: ```sh make ``` + ## To use: ```sh ./cable2 file.bmp [color] ``` -## Try: + +### Try: Here is an OCR example that shows all 94 supported ASCII characters: @@ -57,12 +60,14 @@ And as an added IOCCC bonus: :-) ./cable2 bonus.bmp ``` + ## Judges' remarks: We can confirm that this is the first time the IOCCC has been used to peer-review a new research. We had quite a bit of fun with a sharpie and a scanner. + ## Author's remarks: ### OCR - Obfuscated Character Recognition of Handwritten Text @@ -158,6 +163,7 @@ and endianness conversion would make the source too large for IOCCC rule 2). incompatible pointer conversions - all just a fun consequence of the obfuscations. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2013/cable3/README.md b/2013/cable3/README.md index 91b9a8bc8..4f5105418 100644 --- a/2013/cable3/README.md +++ b/2013/cable3/README.md @@ -14,7 +14,7 @@ An alternate version that should compile in Windows/MS Visual Studio is available. See the [Alternate code](#alternate-code) section below. -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -32,7 +32,7 @@ For more detailed information see [2013 cable3 in bugs.md](/bugs.md#2013-cable3) ``` -## Try: +### Try: ```sh ./runme diff --git a/2013/dlowe/README.md b/2013/dlowe/README.md index 42588be81..3300d0707 100644 --- a/2013/dlowe/README.md +++ b/2013/dlowe/README.md @@ -5,6 +5,7 @@ US\ \ + ## To build: ```sh @@ -12,7 +13,7 @@ make ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -29,7 +30,8 @@ For more detailed information see [2013 dlowe in bugs.md](/bugs.md#2013-dlowe). ./dlowe [numbers...] ``` -## Try: + +### Try: ```sh ./dlowe 0 1 2 3 4 5 6 7 @@ -186,6 +188,7 @@ write an obfuscated C sparkline utility! Vicent Martí created [this one](https://gist.github.com/vmg/1368661) years (!) ago. (My implementation is completely independent.) + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2013/endoh1/README.md b/2013/endoh1/README.md index bc2a7daba..d1375b9e1 100644 --- a/2013/endoh1/README.md +++ b/2013/endoh1/README.md @@ -5,19 +5,22 @@ Yusuke Endoh\ \ Mastodon: [@mame@ruby.social](https://ruby.social/@mame) + ## To build: ```sh make ``` + ## To use: ```sh ./endoh1 [file.lazy] ``` -## Try: + +### Try: ```sh ./endoh1 hello.lazy @@ -28,6 +31,7 @@ echo Hello | ./echo\ Be patient with the last one. + ## Judges' remarks: We liked this entry because it can serve as a standalone program as well as an @@ -37,6 +41,7 @@ the program itself. This entry can be considered an abuse of the GCC's optimizer; it takes GCC about 4x longer to compile it with -O3 than without, compared to clang's 2x. + ## Author's remarks: ### Remarks @@ -218,7 +223,6 @@ ask you one question. Can you tell what `v s[]={0,0,s+6,s+2,s+4,s,s+3,s+5,s+1};` is? I found this by using SMT solver. - ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2013/endoh2/README.md b/2013/endoh2/README.md index 27633e135..88d835ef9 100644 --- a/2013/endoh2/README.md +++ b/2013/endoh2/README.md @@ -5,12 +5,14 @@ Yusuke Endoh\ \ Mastodon: [@mame@ruby.social](https://ruby.social/@mame) + ## To build: ```sh make ``` + ## To use: ```sh @@ -26,7 +28,8 @@ section to enjoy the entry. The [Makefile](Makefile) `check` rule will check if you have both and if either is not found it will report it and tell you where to download one or both before exiting. -## Try: + +### Try: ```sh cat jpeg.c @@ -34,7 +37,9 @@ cat jpeg.c Next look at `jpeg.jpg` in an image viewer program. + ## Judges' remarks: + \ This is a program which, when fed its own source, generates a program that almost is its whitespace inverse, which, in its order, generates a JPEG file @@ -45,6 +50,7 @@ program...) Don't pay attention to the OCR ~~behind the ruby curtain~~ --- it's a straightforward bitmap comparison. + ## Author's remarks: ### Highlights @@ -96,6 +102,7 @@ FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ``` + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2013/endoh3/README.md b/2013/endoh3/README.md index f35b35cd2..a7e21e541 100644 --- a/2013/endoh3/README.md +++ b/2013/endoh3/README.md @@ -5,19 +5,22 @@ Yusuke Endoh\ \ Mastodon: [@mame@ruby.social](https://ruby.social/@mame) + ## To build: ```sh make ``` + ## To use: ```sh ./endoh3 ``` -## Try: + +### Try: Trying this out will depend on how your system can play sounds. The author's remarks include some options for different operating systems. @@ -30,6 +33,7 @@ echo 'CDEFGABc' | ./endoh3 | ruby wavify.rb > cde.wav There are also some other musical samples, twinkle.abc and menuet.abc. + ## Judges' remarks: This program can toot out a tune that is small enough to posted to most social @@ -44,6 +48,7 @@ might be called today. We recommend that you pick a responsible social media platform to post the program's output on. Nevertheless the award of this entry will remain the same for historical purposes. + ## Author's remarks: ### Remarks diff --git a/2013/endoh4/README.md b/2013/endoh4/README.md index 755c56ea1..6816bbd19 100644 --- a/2013/endoh4/README.md +++ b/2013/endoh4/README.md @@ -5,12 +5,14 @@ Yusuke Endoh\ \ Mastodon: [@mame@ruby.social](https://ruby.social/@mame) + ## To build: ```sh make ``` + ## To use: ```sh @@ -22,7 +24,8 @@ The second form is preferable as it will temporarily make the cursor invisible as recommended by the author. If no file is specified in `run.sh` command line it will feed to the program [endoh4.c](endoh4.c). -## Try: + +### Try: ```sh ./run.sh cube.txt @@ -38,12 +41,14 @@ For an example, if you are a football/soccer fan, try: ./run.sh solids/archimedian-solid/a11-truncated-icosahedron.txt ``` + ## Judges' remarks: This program is formatted as the net for a tetrahedron (hint: try feeding the program it's own source code like `./run.sh`). When it runs there is an animation for the computation to work out the convex hull. + ## Author's remarks: ### Spec diff --git a/2013/hou/README.md b/2013/hou/README.md index fa77b1dbf..0d98536f8 100644 --- a/2013/hou/README.md +++ b/2013/hou/README.md @@ -4,6 +4,7 @@ Qiming Hou\ \ \ + ## To build: ```sh @@ -11,7 +12,7 @@ make all ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -32,7 +33,8 @@ Follow the instructions in `stdout`, preferably with an auto-refreshing PPM image viewer ready. Refresh the image every time the output refreshes, all effects should be more or less recognizable when you see 16. -## Try: + +### Try: ```sh ./hou BIG @@ -58,6 +60,7 @@ of the invocations above: This program does not terminate by itself: you must kill `hou` (but not Qiming Hou :-) ) in order to end the program. This should not be fixed. + ## Judges' remarks: You could consider that this program violates the source code size @@ -79,6 +82,7 @@ cc -Wall hou.c -o hou -lm but there is no need to do this as the Makefile takes care of it without even needing to create a temporary file. + ## Author's remarks: ### Using hou @@ -244,6 +248,7 @@ There are a few other tweaks: * The decoder uses an O(n^2) algorithm to avoid the gigabytes-sized hash table frequently found in other PPM implementations. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2013/mills/README.md b/2013/mills/README.md index 282445397..7ec8fb772 100644 --- a/2013/mills/README.md +++ b/2013/mills/README.md @@ -3,19 +3,22 @@ Christopher Mills\ + ## To build: ```sh make ``` + ## To use: ```sh ./mills ``` -## Try: + +### Try: ```sh ./mills & @@ -24,10 +27,12 @@ make While that is running, point your favorite browser at: [http://localhost:8224](http://localhost:8224). + ## Judges' remarks: Who will be the first to post an image rendered during a leap-second? + ## Author's remarks: ### The Program @@ -120,6 +125,7 @@ spherical symmetry of the source code. In addition, I have altered the word `-Dwin_port="sin_addr.s_addr=htonl(2130706433),R.sin_port"`) to protect against curious impressionable youth trying to learn about sockets on Internet. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2013/misaka/README.md b/2013/misaka/README.md index b480c1f89..fb3487803 100644 --- a/2013/misaka/README.md +++ b/2013/misaka/README.md @@ -4,6 +4,7 @@ Don Yang\ \ + ## To build: ```sh @@ -13,6 +14,7 @@ make This will build a bunch of versions of the code. See the author's details for information on all of these builds. + ## To use: ```sh @@ -20,7 +22,8 @@ information on all of these builds. ./vertical_cat [files...] > [output] ``` -## Try: + +### Try: To understand the various intermediate source files that are built, try: @@ -55,6 +58,7 @@ NOTE: Use - for standard input. For example: ./vertical_cat - - ``` + ## Judges' remarks: There is more to cat than [mere cats](http://cheezburger.com/1680494336). Be @@ -78,6 +82,7 @@ preferred otherwise, the flying fish was returned to *swim with the fishes*. :-) No [cats](https://rationalwiki.org/wiki/Fun:Cat) were harmed in the process of judging this entry. + ## Author's remarks: ### Overview @@ -281,6 +286,7 @@ stackable figure: * [Google images](http://google.co.jp/search?q=%E3%83%9F%E3%82%B5%E3%82%AB%E7%9B%9B%E3%82%8A&tbm=isch) * [Kotobukiya](http://main.kotobukiya.co.jp/figure/tsubucole_tmi_misakamori/) + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2013/morgan1/README.md b/2013/morgan1/README.md index edd328ebf..71185c8c8 100644 --- a/2013/morgan1/README.md +++ b/2013/morgan1/README.md @@ -3,19 +3,22 @@ Yves-Marie Morgan\ + ## To build: ```sh make ``` + ## To use: ```sh echo "2013/10/03" | ./morgan1 ``` -## Try: + +### Try: ```sh echo "1985/10/28" | ./morgan1 @@ -25,6 +28,7 @@ echo "1996/12/31" | ./morgan1 Try pressing the arrow keys when your focus is in the window. + ## Judges' remarks: To verify the output, try echoing the date of an evening with a clear sky. @@ -33,6 +37,7 @@ to wait for a better time of the evening. In a few cases, such as the South Pole in the summer, you may need to move to a different observing site. + ## Author's remarks: ### Instructions @@ -110,6 +115,7 @@ To verify the display, you can look at one of this programs : * homeplanet : https://www.fourmilab.ch/homeplanet/ * https://www.theplanetstoday.com + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2013/morgan2/README.md b/2013/morgan2/README.md index 22ca28eb9..767c33d82 100644 --- a/2013/morgan2/README.md +++ b/2013/morgan2/README.md @@ -3,12 +3,14 @@ Yves-Marie Morgan\ + ## To build: ```sh make ``` + ## To use: For the console version (ncurses): @@ -23,12 +25,14 @@ For the graphical version (X11): ./morgan2 X ``` -## Try: + +### Try: ```sh echo "Do or do not. There is no try." ``` + ## Judges' remarks: The judges enjoyed playing the game almost to completion; if we remember @@ -36,6 +40,7 @@ correctly, we managed to place 59 or 60 dominoes. We wonder, what would be faster: to play the game to completion or to write an unobfuscated version of it? + ## Author's remarks: This program is a domino game. The goal is to place dominoes on the 8x8 grid. @@ -140,6 +145,7 @@ morgan2.c:23:24: warning: adding 'int' to a string does not append to the string **!!!!! HAVE FUN !!!!!** + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2013/robison/README.md b/2013/robison/README.md index 0e34025c8..502789423 100644 --- a/2013/robison/README.md +++ b/2013/robison/README.md @@ -3,25 +3,29 @@ Arch D. Robison\ + ## To build: ```sh make ``` + ## To use: ```sh ./robison ``` -## Try: + +### Try: ```sh echo '1*2*3*4*5*6*7*8*9%1000' | ./robison echo '100000000000000000000*(20*(1+(99477941840441*50)))/31664812345028528' | ./robison ``` + ## Judges' remarks: Of integers this prog does a lot,\ @@ -36,6 +40,7 @@ when interactive one values more than throughput. With cut and paste and some time,\ one can compute M(23209). + ## Author's remarks: ### Oh, The Strings You Can C! @@ -106,6 +111,7 @@ With a pound and define, mass production of vars! The moral is clear, for programmers out there:\ With the C lib for strings, you can hack with a flair. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2014/birken/README.md b/2014/birken/README.md index bf0d57aef..ac2ddc847 100644 --- a/2014/birken/README.md +++ b/2014/birken/README.md @@ -8,12 +8,14 @@ Alexander Prishchepov\ \ + ## To build: ```sh make ``` + ## To use: ```sh @@ -22,7 +24,8 @@ make ./prog http://host[:port] ``` -## Try: + +### Try: ```sh ./prog < README.md @@ -47,6 +50,7 @@ What happens if you specify instead of a regular file something like But there's more! Try opening in a browser the same address and then see what happens. This is explained by the authors when explaining their inspiration. + ## Judges' remarks: Port 1701? Well this is not the l2f registered TCP/1701 protocol. @@ -212,6 +216,7 @@ resulting in compiler warnings: It may be necessary to restore some of these under certain environments. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2014/deak/README.md b/2014/deak/README.md index 6a5c3fdf0..8c9fa1edc 100644 --- a/2014/deak/README.md +++ b/2014/deak/README.md @@ -3,6 +3,7 @@ Ferenc Deak\ + ## To build: ```sh @@ -12,13 +13,15 @@ make There is an alternate version that the author provided but fixed in 2023 to compile. See [alternate code](#alternate-code) below. + ## To use: ```sh ./prog ``` -## Try: + +### Try: ```sh ./prog @@ -50,6 +53,7 @@ and Mandelbrot fractal drawing entries we've seen over the years. We liked the use of unary notation facilitated by variadic macros. + ## Author's remarks: ### Portability @@ -105,6 +109,7 @@ Yes, unfortunately there are compiler warnings of the kind "initialization makes integer from pointer without a cast" but the provided Makefile automatically disables them. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2014/endoh1/README.md b/2014/endoh1/README.md index 9e948657a..198ecdb6b 100644 --- a/2014/endoh1/README.md +++ b/2014/endoh1/README.md @@ -5,19 +5,22 @@ Yusuke Endoh\ \ Mastodon: [@mame@ruby.social](https://ruby.social/@mame) + ## To build: ```sh make ``` + ## To use: ```sh ./prog > foo.c ``` -## Try: + +### Try: ```sh ./prog > main.c @@ -66,6 +69,7 @@ When using a smartphone to read the output, you may need to step back to see the bigger picture because that picture is worth more than 1000 words. + ## Author's remarks: ### Remarks @@ -76,6 +80,7 @@ You may want to use a large display with a very small-font terminal. See [spoilers.md](spoilers.md). + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2014/endoh2/README.md b/2014/endoh2/README.md index 8ec390c1f..5356d013f 100644 --- a/2014/endoh2/README.md +++ b/2014/endoh2/README.md @@ -5,19 +5,22 @@ Yusuke Endoh\ \ Mastodon: [@mame@ruby.social](https://ruby.social/@mame) + ## To build: ```sh make ``` + ## To use: ```sh ./prog < input > output ``` -## Try: + +### Try: ```sh echo Hello | ./prog @@ -27,12 +30,14 @@ make hello ./hello ``` + ## Judges' remarks: If you look closely at the source, you will see code that appears to puts C code that includes itself. How and why? Perhaps it is in the DNA code of the code? Perhaps there are 23 reasons? :-) + ## Author's remarks: ### Remarks @@ -54,6 +59,7 @@ Enjoy DNA programming! * The synthesized helix of course follows the base-pairing rules for DNA: A is bonding only to T, and C is bonding only to G. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2014/maffiodo1/README.md b/2014/maffiodo1/README.md index 1b78e05bf..6437a5639 100644 --- a/2014/maffiodo1/README.md +++ b/2014/maffiodo1/README.md @@ -22,7 +22,7 @@ cat mario.level | ./prog 320 200 800 300 128 144 mario.rgba mario8.wav 10343679 ``` -## Try: +### Try: ```sh cat giana.level | ./prog 320 200 1000 300 192 168 giana.rgba giana8.wav 5459393 diff --git a/2014/maffiodo2/README.md b/2014/maffiodo2/README.md index 72ed4c7e7..684059a1b 100644 --- a/2014/maffiodo2/README.md +++ b/2014/maffiodo2/README.md @@ -4,24 +4,28 @@ \ + ## To build: ```sh make ``` + ## To use: ```sh ./prog arg ``` -## Try: + +### Try: ```sh cat image.rgb | ./prog ' .,:;!$#@' ``` + ## Judges' remarks: On the face of it :-) given what this program does one might wonder what makes @@ -31,6 +35,7 @@ to social media that has a small size limit. Who will be the first to tweet this source? How many re-tweets will such tweet get? And how many people will really understand the tweet? + ## Author's remarks: ### Remarks @@ -89,6 +94,7 @@ d=80,e,j;g(){j+=getchar();}main(){for(;;){j=0;g();if(j<0)break;g(g());putchar(" This alternative version have a **fixed ramp**. It's smaller but it's not so fun to use... + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2014/morgan/README.md b/2014/morgan/README.md index 95ca058b0..18b83835a 100644 --- a/2014/morgan/README.md +++ b/2014/morgan/README.md @@ -3,19 +3,22 @@ Yves-Marie Morgan\ + ## To build: ```sh make ``` + ## To use: ```sh ./prog [arg ..] ``` -## Try: + +### Try: ```sh make @@ -34,6 +37,7 @@ make ls ``` + ## Judges' remarks: Think of this as a Maker Faire's make. :-) @@ -41,6 +45,7 @@ Think of this as a Maker Faire's make. :-) It works reasomably well. While not super ultra-featured, it does fair well with the Makefile we supplied. Not only that, it helped uncover a bug we had in our special Makefile rules. + ## Author's remarks: ### Remarks @@ -90,6 +95,7 @@ with gcc 4.8.2 on Linux Ubuntu 14.04 64-bit : * prog.c:23:72: warning: signed and unsigned type in conditional expression [-Wsign-compare] * prog.c:12:11: warning: suggest parentheses around ‘&&’ within ‘||’ [-Wparentheses] + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2014/sinon/README.md b/2014/sinon/README.md index 620694900..3eca2f220 100644 --- a/2014/sinon/README.md +++ b/2014/sinon/README.md @@ -4,30 +4,35 @@ \ + ## To build: ```sh make ``` + ## To use: ```sh cp -f sinon.c run.c; ./hecate.sh ``` -## Try: + +### Try: ```sh cp -f sinon.c run.c; ./hecate.sh; ./glock.sh; sleep 3; ./glock.sh; sleep 1; ./hecate.sh ``` + ## Judges' remarks: Try to figure out how this entry determines the optimization level with which it had been compiled. Is this an example of undefined behavior or unspecified behavior? + ## Author's remarks: ### Summary @@ -111,6 +116,7 @@ Process for making Sinon is included in spoiler.html. Layout of this code is based on Asada Shino, also known as "Sinon", from Sword Art Online. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2014/skeggs/README.md b/2014/skeggs/README.md index 4cfad6566..dae43d512 100644 --- a/2014/skeggs/README.md +++ b/2014/skeggs/README.md @@ -4,19 +4,22 @@ \ + ## To build: ```sh make ``` + ## To use: ```sh ./prog ``` -## Try: + +### Try: ```sh echo "Do or do not. There is no try." @@ -26,6 +29,7 @@ HINT: Try pressing the left and right arrow keys as needed. Also try pressing space/enter to select options. Pressing Q or Escape may end the fun before you are ready. :-) + ## Judges' remarks: When the code looks like lemons, it is probably because the LEMONPEOPLE, @@ -40,6 +44,7 @@ is being written to a file and then compiled. And yet that compiled code is somehow executed from main. But how? How is main able to call code that was written and compiled just in time for execution? + ## Author's remarks: ### TABLE OF CONTENTS @@ -226,6 +231,7 @@ I ran out of time to test it on more systems. `5092` + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2014/vik/README.md b/2014/vik/README.md index ed87ff5af..7f4be16d8 100644 --- a/2014/vik/README.md +++ b/2014/vik/README.md @@ -14,7 +14,7 @@ make ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -35,7 +35,8 @@ There is an alternate version that will theoretically work with Windows compilers (if anything in Windows works :-) ). See the [Alternate code](#alternate-code) section below. -## Try: + +### Try: ```sh echo 'Want to hear me beep?' | ./prog > audio_file.raw diff --git a/2014/wiedijk/README.md b/2014/wiedijk/README.md index 9b46b5a35..6125f4816 100644 --- a/2014/wiedijk/README.md +++ b/2014/wiedijk/README.md @@ -3,24 +3,28 @@ Freek Wiedijk\ + ## To build: ```sh make ``` + ## To use: ```sh ./prog ``` -## Try: + +### Try: ```sh cc -E prog.c | indent | sed '1,/5.*prog/d' ``` + ## Judges' remarks: C11 features definitely help this entry to be as concise as it is. @@ -29,6 +33,7 @@ The judges would like to think that they had almost understood how this entry wo If you win a bet by demonstrating this entry, please let us know. + ## Author's remarks: ### Remarks @@ -57,6 +62,7 @@ If you win a bet by demonstrating this entry, please let us know. - 10! seconds = 6 weeks - answers the ultimate question of life, the universe and everything + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2015/burton/README.md b/2015/burton/README.md index 4eec07a32..5e1fd0baf 100644 --- a/2015/burton/README.md +++ b/2015/burton/README.md @@ -3,12 +3,14 @@ Dave Burton + ## To build: ```sh make ``` + ## To use: ```sh @@ -23,7 +25,8 @@ or: Type in expressions on standard input. -## Try: + +### Try: ```sh ./prog '?0x3343<<2' @@ -63,6 +66,7 @@ make alt Use `prog.alt` as you would `prog` above. + ## Judges' remarks: "Look, Ma, no ~~hands~~ digits!" @@ -73,6 +77,7 @@ modulo, are easy to find. Where are addition and subtraction? We were impressed with the level of detail the author "blogged" the obfuscation process. + ## Author's remarks: ### calc - an integer expression calculator that outputs in both hex and decimal @@ -224,6 +229,7 @@ PATH=. eprog < test.in | diff - test.out If you do not want to puzzle out how it works, see [spoilers.md](spoilers.md). + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2015/dogon/README.md b/2015/dogon/README.md index 4ad101235..2bcba5afd 100644 --- a/2015/dogon/README.md +++ b/2015/dogon/README.md @@ -3,19 +3,22 @@ Gil Dogon\ + ## To build: ```sh make ``` + ## To use: ```sh ./prog ``` -## Try: + +### Try: ```sh ./prog @@ -47,6 +50,7 @@ etc. Press the ESC key + ## Judges' remarks: You are in a twisty maze blocks, almost all alike. @@ -60,6 +64,7 @@ number function keys such as F30 or F31? :-) *Textures? We don't need no stinking textures.* + ## Author's remarks: ### What is it? @@ -188,6 +193,7 @@ adjusted simultaneously by the expression: `o=o*b>>8`. Of course some spare bits are needed between the components, so they are spread in the long long and reordered as RBG. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2015/duble/README.md b/2015/duble/README.md index f538a44dc..93299d06d 100644 --- a/2015/duble/README.md +++ b/2015/duble/README.md @@ -3,19 +3,22 @@ Etienne Duble \ + ## To build: ```sh make ``` + ## To use: ```sh echo Some text | ./prog ``` -## Try: + +### Try: ```sh echo Hello, world | ./prog @@ -48,6 +51,7 @@ Beautiful penmanship! However, your fonts may vary. How does this entry compress the font it uses? What's the purpose of lrand48()? Why does the program dump core, when it does :) ? + ## Author's remarks: ### Introduction @@ -208,6 +212,7 @@ have to check whether their standard input is a terminal or not (by using `isatty()`). Did you notice that this program does not perform any such detection, but still behaves (or seems to behave) appropriately? + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2015/endoh1/README.md b/2015/endoh1/README.md index ffc5cb7b3..2f2763549 100644 --- a/2015/endoh1/README.md +++ b/2015/endoh1/README.md @@ -6,12 +6,14 @@ Mastodon: [@mame@ruby.social](https://ruby.social/@mame) Someone Anonymous + ## To build: ```sh make ``` + ## To use: ```sh @@ -21,12 +23,13 @@ make Connect to port http://localhost:10333 with your browser. -## Try: +### Try: ```sh echo "Do or do not. There is no try." ``` + ## Judges' remarks: [How did the leopard get its @@ -38,6 +41,7 @@ Turing](https://en.wikipedia.org/wiki/Alan_Turing), there are some pointers to his features like eyes with "`stdeye-o`" and "`<--mouth`". Can you find any other tributes? + ## Author's remarks: What does "[Alan Turing](https://en.wikipedia.org/wiki/Alan_Turing)" remind you @@ -216,6 +220,7 @@ field data to the browser on each frame. * [4] Eastlake 3rd, D. and P. Jones, "US Secure Hash Algorithm 1 (SHA1)", RFC 3174, DOI 10.17487/RFC3174, September 2001, . * [5] Josefsson, S., "The Base16, Base32, and Base64 Data Encodings", RFC 4648, DOI 10.17487/RFC4648, October 2006, . + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2015/endoh2/README.md b/2015/endoh2/README.md index 9c5db42fd..88c2d2854 100644 --- a/2015/endoh2/README.md +++ b/2015/endoh2/README.md @@ -4,19 +4,22 @@ Yusuke Endoh\ \ Mastodon: [@mame@ruby.social](https://ruby.social/@mame) + ## To build: ```sh make ``` + ## To use: ```sh ./prog ``` -## Try: + +### Try: ```sh cat prog.c @@ -24,6 +27,7 @@ cat prog.c ./prog | diff - prog.c ``` + ## Judges' remarks: At this point you might be wondering, [WTF](http://acronyms.thefreedictionary.com/WTF)?\* @@ -47,6 +51,7 @@ Where did those underscores come from? Well [RTFS](http://acronyms.thefreedicti If you are still puzzled, look at prog.c with your favorite text editor. + ## Author's remarks: **Follow this instruction literally!** @@ -64,6 +69,7 @@ Hint 2: Do `wc -c prog.c`. This is very long one-liner. Spoiler: Open the source with an editor like `vim` or `emacs`. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2015/endoh3/README.md b/2015/endoh3/README.md index cec7dac96..4d58fd298 100644 --- a/2015/endoh3/README.md +++ b/2015/endoh3/README.md @@ -19,7 +19,7 @@ make ``` -## Try: +### Try: To see the original [mullender](mullender.c) in action: @@ -59,6 +59,7 @@ instructions clue, see the end of the author's remarks.) If in doubt, use [APOUT](https://github.com/DoctorWkt/Apout). + ## Author's remarks: ### Hint / Compatibility @@ -238,6 +239,7 @@ short main[]={5568,1,-30460,12,2782,0,-29921,2056,-4864,6873,770,30054,11886, 335,-27277,-30776,20480,0}; ``` + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2015/endoh4/README.md b/2015/endoh4/README.md index 19bfbd6d6..e4e446929 100644 --- a/2015/endoh4/README.md +++ b/2015/endoh4/README.md @@ -4,19 +4,22 @@ Yusuke Endoh\ \ Mastodon: [@mame@ruby.social](https://ruby.social/@mame) + ## To build: ```sh make ``` + ## To use: ```sh ./prog ``` -## Try: + +### Try: ```sh ./prog @ @ @ @ @ @ @@ -43,6 +46,7 @@ make alt Use `prog.alt` as you would `prog` above. + ## Judges' remarks: For this one liner it is best to avoid prime numbers. The output groups @@ -50,6 +54,7 @@ factors in the x-y dimensions. How many factors can be represented before you run out of command line argument space? How could you modify the program to experiment with numbers that have more or larger factors? + ## Author's remarks: Visual factorization 1-liner. Try: @@ -70,6 +75,7 @@ Diagrams](http://www.datapointed.net/visualizations/math/factorization/animated- Dogon](/winners.html#Gil_Dogon) kindly improved it during the review. Thank you! + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2015/hou/README.md b/2015/hou/README.md index 4aebea711..d52748137 100644 --- a/2015/hou/README.md +++ b/2015/hou/README.md @@ -3,24 +3,28 @@ Qiming Hou \ + ## To build: ```sh make ``` + ## To use: ```sh echo IOCCC | ./prog ``` -## Try: + +### Try: ```sh echo "" | ./prog ``` + ## Judges' remarks: A good start for understanding this entry might be @@ -47,6 +51,7 @@ What happens with a large file? Something over 256K Where does that message come from? + ## Author's remarks: This looks like a normal C program. @@ -108,6 +113,7 @@ Tested platforms: * Windows 8.1, x86, MinGW gcc 4.6.2 (fails, prints error message) * Windows 8.1, x86, MinGW gcc 4.6.2 with -msse2 -mfpmath=sse (works) + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2015/howe/README.md b/2015/howe/README.md index b0e0ee329..efb2c6cbb 100644 --- a/2015/howe/README.md +++ b/2015/howe/README.md @@ -4,12 +4,14 @@ Anthony Howe \ Montreal, Quebec, Canada\ + ## To build: ```sh make ``` + ## To use: ```sh @@ -18,7 +20,8 @@ make ./prog -d file1 file2 ``` -## Try: + +### Try: ```sh ./prog prog.alt.c prog.c @@ -57,6 +60,7 @@ make alt Use `prog.alt` as you would `prog` above. + ## Judges' remarks: This is the best use of the FNV that we have seen in the IOCCC so far! @@ -81,6 +85,7 @@ might be easier than the academic papers it was inspired by. NOTE: Unlike the original entry source, prog.alt.c, prog.c uses a 64 bit FNV hash and fixes a function call warning. + ## Author's remarks: ### Features @@ -171,6 +176,7 @@ Which hashing algorithm is best for uniqueness and speed?\ [HshCmp]: http://programmers.stackexchange.com/questions/49550/which-hashing-algorithm-is-best-for-uniqueness-and-speed + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2015/mills1/README.md b/2015/mills1/README.md index daf378562..f4c5127a5 100644 --- a/2015/mills1/README.md +++ b/2015/mills1/README.md @@ -2,19 +2,22 @@ Chris Mills + ## To build: ```sh make ``` + ## To use: ```sh ./prog ``` -## Try: + +### Try: ```sh ./prog @@ -22,6 +25,7 @@ make Press the up arrow and the down arrow at the right time. + ## Judges' remarks: Did you find that mobile application game a bit frustrating? @@ -73,6 +77,7 @@ Enjoy! TAP!! TAP!! TAP!! FLAP! FLAP! FLAP! + ## Author's remarks: ### The Program @@ -154,6 +159,7 @@ Future versions of the game will include monitization via the freemium model with micropayments for customization options, play-to-win and of course live-streamed targeted video advertising. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2015/mills2/README.md b/2015/mills2/README.md index 335d7e823..513c24a89 100644 --- a/2015/mills2/README.md +++ b/2015/mills2/README.md @@ -2,19 +2,22 @@ Chris Mills + ## To build: ```sh make ``` + ## To use: ```sh ./prog compressed_file.Z ``` -## Try: + +### Try: ```sh printf '000I\236\f\31H\260\240\301\203' > ioccc.Z @@ -29,6 +32,7 @@ compress < test2 > test2.Z time ./prog test2.Z | cmp - test2 ``` + ## Judges' remarks: Without ASCII art, the source code of this entry would have been exactly 256 @@ -38,6 +42,7 @@ for a compress(1)-like compressor using a similar idea. Why is the sad smiley on line 12 in that particular place? + ## Author's remarks: ### The Program @@ -126,6 +131,7 @@ pass in an alternate universe where the vax on which `compress` was authored had been big-endian. Luckily for us, it wasn't, and neither are most of the systems you might want to compile this for. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2015/muth/README.md b/2015/muth/README.md index 4ce01658a..c6c2cf0f8 100644 --- a/2015/muth/README.md +++ b/2015/muth/README.md @@ -3,19 +3,22 @@ Dominik Muth\ + ## To build: ```sh make ``` + ## To use: ```sh make -B [MACHINE=your_machine.h] [TAPE=your_tape.h] [X=[0|1|2|3|4|5|6|7|8|9]] [V=[0|1|2]] run ``` -## Try: + +### Try: ```sh make -B V=2 run @@ -27,12 +30,14 @@ make -B MACHINE=machine_times2.h TAPE=tape_five.h V=1 run make -B MACHINE=machine_chaos_5_2.h X=5 run ``` + ## Judges' remarks: This is something we were fearing all along: that the C preprocessor is Turing-complete even without conditionals and recursive file inclusion as some kind of a [rewriting system](https://en.wikipedia.org/wiki/Rewriting). Now we have the proof! + ## Author's remarks: ### Preprocessor Turing Engine @@ -107,6 +112,7 @@ To halt the machine, use the keyword "`break`" as in #define A_1 (2, break) + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2015/schweikhardt/README.md b/2015/schweikhardt/README.md index 098e5397f..1f64663a9 100644 --- a/2015/schweikhardt/README.md +++ b/2015/schweikhardt/README.md @@ -3,12 +3,14 @@ Jens Schweikhardt\ + ## To build: ```sh make ``` + ## To use: ```sh @@ -17,12 +19,14 @@ make where n is a base 16 number of any size. -## Try: + +### Try: ```sh ./prog 19 ``` + ## Judges' remarks: This code is clean. When you compile with all warnings enabled, @@ -77,6 +81,7 @@ build some very complex structures. :-) p.s. We appreciated that apart from a few powers of 2, the source code is magic number free. + ## Author's remarks: ### The TL;DR version @@ -781,6 +786,7 @@ memory resources with the ulimit(1) built-in of your shell. For all intents and purposes, the *Not Overflowing Type* keeps the promise! + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2015/yang/README.md b/2015/yang/README.md index 2e2232169..915df2174 100644 --- a/2015/yang/README.md +++ b/2015/yang/README.md @@ -18,7 +18,7 @@ echo Some text | ./prog\ ``` -## Try: +### Try: ```sh echo IOCCC 2015 | ./prog | tee output.c diff --git a/2018/algmyr/README.md b/2018/algmyr/README.md index bbf42735d..3708ec84b 100644 --- a/2018/algmyr/README.md +++ b/2018/algmyr/README.md @@ -2,6 +2,7 @@ Anton Älgmyr + ## To build: ```sh @@ -9,7 +10,7 @@ make ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -30,7 +31,8 @@ cat prog.c | ./prog # Printing garbage might break your font NOTE: this entry will crash if a file specified cannot be opened. -## Try: + +### Try: ```sh ./prog -h | ./prog -d 1 0 @@ -49,6 +51,7 @@ echo -n ' MENE MENE TEKEL UPHARSIN ' | ./prog |\ # now open spectrogram.png with a graphics viewer or editor ``` + ## Judges' remarks: Be warned, this is not your garden variety text-to-speech program! Earplugs are advised, @@ -59,6 +62,7 @@ and the message can be displayed in fiery letters, but don't be alarmed. How does decoding of the waveform work? Can you encode an arbitrary text in a sound sample? + ## Author's remarks: ### What is this? @@ -190,6 +194,7 @@ myself. :( The reported size of the source code using the size tool is very intentionally 2018. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2018/anderson/README.md b/2018/anderson/README.md index c23b43cc8..fdc14b961 100644 --- a/2018/anderson/README.md +++ b/2018/anderson/README.md @@ -2,19 +2,22 @@ Derek Anderson + ## To build: ```sh make ``` + ## To use: ```sh ./prog < textfile ``` -## Try: + +### Try: ```sh ./prog < prog.c @@ -38,10 +41,12 @@ make alt Use `prog.alt` as you would `prog` above. + ## Judges' remarks: With this entry, you won't need to turn your monitor [upside down](http://en.wikipedia.org/wiki/River_%28typography%29)! + ## Author's remarks: ### Compiling the program: @@ -85,6 +90,7 @@ variable assignment, such as `j=k`. There is some filler fluff, such as added for the purpose of making certain things line up right, and only secondarily to obfuscate. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2018/bellard/README.md b/2018/bellard/README.md index c2e5001a7..10f746e58 100644 --- a/2018/bellard/README.md +++ b/2018/bellard/README.md @@ -3,19 +3,22 @@ Fabrice Bellard\ + ## To build: ```sh make ``` + ## To use: ```sh ./prog > lena.ppm ``` -## Try: + +### Try: ```sh eog lena.ppm # On Linux @@ -25,6 +28,7 @@ pngtopnm < Lenna.png | pnmscale 0.25 | cjpeg -arithmetic -dct float -quality 14 ``` ### NOTE: Lenna.png is from https://upload.wikimedia.org/wikipedia/en/7/7d/Lenna_%28test_image%29.png + ## Judges' remarks: The file `small.jpg` will be approximately of the same size as the raw image @@ -39,6 +43,7 @@ We could understand some of the arithmetic but none of the magic. Deciphering the mechanism used for data encoding to make use of whitespace, braces and semicolons should be a slightly easier task. + ## Author's remarks: Warning: the program is not protected against invalid input. @@ -87,6 +92,7 @@ the output. [1]: https://commons.wikimedia.org/wiki/File%3AFruits_oranges%2C_jardin_japonais_2.JPG [2]: https://commons.wikimedia.org/wiki/File%3ARed_Bull_Jungfrau_Stafette%2C_10th_stage_-_vintage_cars_%282%29.jpg + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2018/burton1/README.md b/2018/burton1/README.md index 0d70cea7c..198f55b1e 100644 --- a/2018/burton1/README.md +++ b/2018/burton1/README.md @@ -3,19 +3,22 @@ Dave Burton\ + ## To build: ```sh make ``` + ## To use: ```sh ./prog < any-file ``` -## Try: + +### Try: ```sh ./prog < prog @@ -34,10 +37,12 @@ To compile this alternate version: make alt ``` + ## Judges' remarks: One line, one array, one loop and one statement but it prints many bytes. It won. + ## Author's remarks: Feed this anything on stdin. @@ -249,6 +254,7 @@ cat prog.c prog.alt.c to compare the differences (`diff` is not helpful on a one-liner). + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2018/burton2/README.md b/2018/burton2/README.md index aaddcb14c..f2e8256c0 100644 --- a/2018/burton2/README.md +++ b/2018/burton2/README.md @@ -3,19 +3,22 @@ Dave Burton\ + ## To build: ```sh make ``` + ## To use: ```sh ./prog [-tcksri] < file.c ``` -## Try: + +### Try: ```sh ./prog -i < prog.c @@ -35,11 +38,13 @@ If you get really stuck, try: man ./tac.man ``` + ## Judges' remarks: They say size isn't everything, and in the case of IOCCC [iocccsize.c](https://www.ioccc.org/2018/iocccsize.c) that is saying something! What is this program weighing and how much does it weigh? + ## Author's remarks: ### tac - tokenize and count C and derivative languages: @@ -410,6 +415,7 @@ Try: ./manpage -h | ./manpage -P | lpr ``` + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2018/ciura/README.md b/2018/ciura/README.md index 3246c46bd..6952abb0f 100644 --- a/2018/ciura/README.md +++ b/2018/ciura/README.md @@ -2,19 +2,22 @@ Marcin Ciura + ## To build: ```sh make ``` + ## To use: ```sh ./prog < text ``` -## Try: + +### Try: ```sh ./prog < Makefile @@ -42,6 +45,7 @@ We're not really sure: prog.c wasn't commented. Who has been thoroughly puzzled by prog? Also how obfuscated is prog? Having been written in C, how large of a vocabulary has it? + ## Author's remarks: ### The Program: @@ -252,6 +256,7 @@ I have tested it on: For a clean compile under C89 and C90, add `-Woverlength-strings` to `CSILENCE`. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2018/endoh1/README.md b/2018/endoh1/README.md index a56cee53e..3a77839d7 100644 --- a/2018/endoh1/README.md +++ b/2018/endoh1/README.md @@ -4,25 +4,29 @@ Yusuke Endoh\ \ Mastodon: [@mame@ruby.social](https://ruby.social/@mame) + ## To build: ```sh make ``` + ## To use: ```sh ./prog < textfile > output.gif ``` -## Try: + +### Try: ```sh ./prog < golem.txt > golem.gif ./prog < smily.txt > smily.gif ``` + ## Judges' remarks: To get the best experience, use a GIF viewer that can handle animated gifs. @@ -37,6 +41,7 @@ You should only give this program printable ASCII characters. Unfortunately this won't run on your PDP8, if you had one, as it needs at least 2MiB of memory to run in. + ## Author's remarks: This program generates an animated GIF from a plain text. Run: @@ -62,6 +67,7 @@ The program itself has a hidden message. ./prog < prog.c > prog.gif ``` + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2018/endoh2/README.md b/2018/endoh2/README.md index d7d651255..9af44889b 100644 --- a/2018/endoh2/README.md +++ b/2018/endoh2/README.md @@ -4,19 +4,22 @@ Yusuke Endoh\ \ Mastodon: [@mame@ruby.social](https://ruby.social/@mame) + ## To build: ```sh make ``` + ## To use: ```sh ./prog ``` -## Try: + +### Try: ```sh ./prog | tee prog_next.c @@ -32,6 +35,7 @@ make python3 NOTE: to interrupt the loop send intr (typically ctrl-C). + ## Judges' remarks: And now for something completely different: A program whose metabolic @@ -39,8 +43,8 @@ processes are a matter of interest only to historians. It has kicked the bucket and departed to that mysterious country from whose bourne no traveller returns! This is an EX-tremely obfuscated program! -## Author's remarks: +## Author's remarks: A high-context work that combines parrots that new hackers like and parrots that old hackers like. One is an internet meme called [Party @@ -90,6 +94,7 @@ opening. | | ``` + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2018/ferguson/README.md b/2018/ferguson/README.md index 7bad9d175..693b3af10 100644 --- a/2018/ferguson/README.md +++ b/2018/ferguson/README.md @@ -5,19 +5,22 @@ Cody Boone Ferguson \ [https://xexyl.net](https://xexyl.net)\ Mastodon: [@xexyl@fosstodon.org](https://fosstodon.org/@xexyl) + ## To build: ```sh make ``` + ## To use: ```sh ./weasel ``` -## Try: + +### Try: ```sh ./weasel words @@ -34,6 +37,7 @@ The author provided an alternate version which has a simpler keyboard for the monkey Eric. See his comments under the 'keyboards' section, briefly referred to in the 'what it is' section. + ## Judges' remarks: Looking back over the strata of past IOCCC entries, this program marks a new @@ -56,6 +60,7 @@ If you find yourself in an evolutionary dead end, try: man ./weasel.man ``` + ## Author's remarks: 0. Preface @@ -1218,6 +1223,7 @@ email but I'm more likely to respond to mastodon messages. [https://ioccc.xexyl.net/2018/weasel]: https://ioccc.xexyl.net/2018/weasel [errata page]: https://ioccc.xexyl.net/2018/weasel/errata + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2018/giles/README.md b/2018/giles/README.md index fac3619f3..bb3434c68 100644 --- a/2018/giles/README.md +++ b/2018/giles/README.md @@ -2,6 +2,7 @@ Edward Giles + ## To build: This entry requires SDL2 to be installed. @@ -88,7 +89,8 @@ See also the judges' remarks below. ./prog ``` -## Try: + +### Try: ```sh ./prog ioccc.txt @@ -97,6 +99,7 @@ See also the judges' remarks below. ./prog sand.alt.txt ``` + ## Judges' remarks: Can you explain the behavior of the program when ioccc.txt is given to it as input? @@ -113,6 +116,7 @@ brew install sdl2 # macOS via Homebrew sudo port install libsdl2 # macOS via MacPorts ``` + ## Author's remarks: ### Remarks @@ -140,6 +144,7 @@ The preprocessor is used to both obfuscate the code as a whole and abbreviate the calls to SDL. Additionally, throughout the code, the variables were named so that they are short and easily confused with each other. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2018/hou/README.md b/2018/hou/README.md index 8b4316bcf..d7c87d311 100644 --- a/2018/hou/README.md +++ b/2018/hou/README.md @@ -2,6 +2,7 @@ Qiming Hou + ## To build: ```sh @@ -9,7 +10,7 @@ make ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -28,7 +29,8 @@ For more detailed information see [2018 hou in bugs.md](/bugs.md#2018-hou). View `output.html` in a browser. -## Try: + +### Try: ```sh grep -e '[-?+*/^&|.<>=]' prog.c @@ -43,6 +45,7 @@ View `output.html` in a browser. What's not right with the output? How can one fix it? + ## Judges' remarks: This entry exhibits a way of obfuscation we haven't seen before, we think. @@ -50,6 +53,7 @@ The rulez of programming in an imperative language are violated, aren't they? Try figuring out how to increase the number of different colors, if you can. + ## Author's remarks: Nowadays almost every programmer needs to do some Web chore. With all the open @@ -68,6 +72,7 @@ common UNIX stuff) to build this and an HTML5-compatible browser to open the result. And it terminates with an assertion failure, but who cares if the web page is already generated? + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2018/mills/README.md b/2018/mills/README.md index 726a0125e..c63e5fc3a 100644 --- a/2018/mills/README.md +++ b/2018/mills/README.md @@ -2,19 +2,22 @@ Christopher Mills + ## To build: ```sh make ``` + ## To use: ```sh ./prog ``` -## Try: + +### Try: ```sh ./prog @@ -79,6 +82,7 @@ otherwise the output will be in all caps. NOTE: To quit v6, press Control-E. + ## Author's remarks: > *This IOCCC entry is dedicated to the late Dennis M. Ritchie* @@ -724,6 +728,7 @@ time... [17]: http://bitsavers.trailing-edge.com "Bitsavers.org" [18]: https://www.bell-labs.com/usr/dmr/www/ "DMR Homepage" + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2018/poikola/README.md b/2018/poikola/README.md index dea22bafe..538d3795a 100644 --- a/2018/poikola/README.md +++ b/2018/poikola/README.md @@ -19,7 +19,7 @@ make ``` -## Try: +### Try: On terminal supports 24 bit color, has black background, and size at least 125x38, try: diff --git a/2018/vokes/README.md b/2018/vokes/README.md index cb1bc559c..092d990af 100644 --- a/2018/vokes/README.md +++ b/2018/vokes/README.md @@ -2,19 +2,22 @@ Scott Vokes + ## To build: ```sh make ``` + ## To use: ```sh ./prog < example-1.txt ``` -## Try: + +### Try: ```sh ./prog < example-2.txt @@ -22,6 +25,7 @@ make ./prog < ioccc.txt ``` + ## Judges' remarks: What this program does is not witchcraft and there are no spectres, but you @@ -31,6 +35,7 @@ This entry is designed to mislead in many ways. However, if you find yourself wanting to know the possibilities for navigating a graph, you will get the answer you seek with no hocus pocus. + ## Author's remarks: ### Introduction: @@ -213,6 +218,7 @@ under "Obfuscations". the values 48 through 57, rather than using `isdigit()`. As noted above, this program has nothing to do with a hand. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2018/yang/README.md b/2018/yang/README.md index 25659cf9f..260bf676f 100644 --- a/2018/yang/README.md +++ b/2018/yang/README.md @@ -3,12 +3,14 @@ Don Yang\ + ## To build: ```sh make ``` + ## To use: ```sh @@ -17,7 +19,8 @@ more generated2.c more generated3.c ``` -## Try: + +### Try: ```sh ./left < prog.c @@ -31,6 +34,7 @@ more generated3.c ./msg2 ``` + ## Judges' remarks: Code should be readable in any direction! This tool will help you rotate your @@ -57,6 +61,7 @@ The final message can be revealed using But what combinations will generate `./msg3`, `./msg4`, `./msg5`, `./msg6`, `./msg7`, `./msg8` and finally `./msg9`? + ## Author's remarks: ### Tools' usage: @@ -170,6 +175,7 @@ Nuko has been verified to work with these compiler / OS combinations: Nuko compiles without warnings with all compilers above, even with `-Wall -Wextra -pedantic` for gcc and clang. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2019/adamovsky/README.md b/2019/adamovsky/README.md index b8bca708a..4a225e440 100644 --- a/2019/adamovsky/README.md +++ b/2019/adamovsky/README.md @@ -2,19 +2,22 @@ Ondřej Adamovský + ## To build: ```sh make ``` + ## To use: ```sh ./prog file.unl ``` -## Try: + +### Try: ```sh ./prog spam.unl @@ -24,6 +27,7 @@ make ./prog advent.unl ``` + ## Judges' remarks: Even after pre-processing and indenting, the C code of this entry @@ -39,6 +43,7 @@ bytes which crashed it: Functional programming is not a panacea against core dumps, after all. + ## Author's remarks: **»A highly structured state state machine«** @@ -267,6 +272,7 @@ be applied. [8]: https://inazz.jp/unlambda/ "Online Unlambda interpreter" [9]: http://ioccc.org/2014/birken/hint.html "Best use of port 1701" + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2019/burton/README.md b/2019/burton/README.md index 81bb4c5d7..ce71f93c7 100644 --- a/2019/burton/README.md +++ b/2019/burton/README.md @@ -2,30 +2,35 @@ Dave Burton + ## To build: ```sh make ``` + ## To use: ```sh ./prog < prog.c ``` -## Try: + +### Try: ```sh echo "Do or do not. There is no try." ``` + ## Judges' remarks: A tiny, but punctually correct way of POSIX counting for text files. This one line, one word, 127 character beauty continues to expand the number of classic unix utilities available as winning entries. + ## Author's remarks: ### Synopsis: @@ -86,6 +91,7 @@ cc -Wall -Wextra -Weverything -pedantic -include stdio.h -o prog.clean prog.clea The flags are not supported. Although they could easily be added into `cow`. This exercise left to the reader. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2019/ciura/README.md b/2019/ciura/README.md index 4b9cdb10c..e9adcaa3e 100644 --- a/2019/ciura/README.md +++ b/2019/ciura/README.md @@ -10,7 +10,7 @@ make ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -28,7 +28,7 @@ For more detailed information see [2019 ciura in bugs.md](/bugs.md#2019-ciura). ``` -## Try: +### Try: ```sh ./getwords.sh en | grep .. | ./prog aeiouvwxyz diff --git a/2019/diels-grabsch1/README.md b/2019/diels-grabsch1/README.md index e754ec9d0..e5f4e7bcf 100644 --- a/2019/diels-grabsch1/README.md +++ b/2019/diels-grabsch1/README.md @@ -18,7 +18,7 @@ make ``` -## Try: +### Try: ```sh dd bs=1024 count=2048 < /dev/zero | compress > ref.Z diff --git a/2019/diels-grabsch2/README.md b/2019/diels-grabsch2/README.md index e259152e9..60b233bf6 100644 --- a/2019/diels-grabsch2/README.md +++ b/2019/diels-grabsch2/README.md @@ -18,7 +18,7 @@ make ``` -## Try: +### Try: ```sh sha512sum prog.c || shasum -a 512 prog.c diff --git a/2019/dogon/README.md b/2019/dogon/README.md index 3b8c3d601..f362285ea 100644 --- a/2019/dogon/README.md +++ b/2019/dogon/README.md @@ -2,19 +2,22 @@ Gil Dogon + ## To build: ```sh make ``` + ## To use: ```sh ./prog < pattern.mc ``` -## Try: + +### Try: ```sh ./prog < glider.mc @@ -28,6 +31,7 @@ make ./prog < message.mc ``` + ## Judges' remarks: [1991/davidguy](http://ioccc.org/years.html#1991_davidguy), @@ -50,6 +54,7 @@ We truly have not much more to add, except two things: In the interest of saving lives, this entry was not fuzzed. + ## Author's remarks: ### What is it? @@ -237,6 +242,7 @@ hs0 << 8, hs1w8 = hs1 >> 8, hs1e8 = hs1 << 8, ts0 = hs0w8 ^ hs0e8, ts1 = (hs0w8 This uses only 19 bitwise operations and six shifts to calculate the inner 6x6 next generation bits of the input 8x8 ! + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2019/duble/README.md b/2019/duble/README.md index 3c9092547..023df9a37 100644 --- a/2019/duble/README.md +++ b/2019/duble/README.md @@ -3,6 +3,7 @@ Etienne Duble\ + ## To build: ```sh @@ -10,7 +11,7 @@ make ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -27,7 +28,8 @@ For more detailed information see [2019 duble in bugs.md](/bugs.md#2019-duble). ./prog file ``` -## Try: + +### Try: ```sh ./prog /tmp/drawing @@ -86,11 +88,13 @@ make alt Use `prog.alt` as you would `prog` above. + ## Judges' remarks: After starting the program, use the cursor keys, then try some modes, like `p` or `l` (they toggle). + ## Author's remarks: ### Introduction: @@ -223,6 +227,7 @@ and it works on macOS too! I must confess it was challenging to remain below the size limit with this little change. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2019/endoh/README.md b/2019/endoh/README.md index 36cfe4ea1..f76a8b2aa 100644 --- a/2019/endoh/README.md +++ b/2019/endoh/README.md @@ -4,6 +4,7 @@ Yusuke Endoh\ \ Mastodon: [@mame@ruby.social](https://ruby.social/@mame) + ## To build: ```sh @@ -11,7 +12,7 @@ make ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -28,17 +29,20 @@ For more detailed information see [2019 endoh in bugs.md](/bugs.md#2019-endoh). ./prog ``` -## Try: + +### Try: ```sh gdb ./prog || lldb ./prog ``` + ## Judges' remarks: The purpose of this program is to crash. You'll want to have memorized `man 7 ascii` when debugging it to reveal its purpose. + ## Author's remarks: ### backtrace quine: @@ -117,6 +121,7 @@ gdb -q -x prog.c ./prog | sed -n -r 's/#.*:([0-9]+)/\1/p' | awk '{printf "%c",$1 diff prog.c prog2.c ``` + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2019/giles/README.md b/2019/giles/README.md index d8988dbd5..0edfedd2b 100644 --- a/2019/giles/README.md +++ b/2019/giles/README.md @@ -2,19 +2,22 @@ Edward Giles + ## To build: ```sh make ``` + ## To use: ```sh ./prog infile.wav outfile.wav ``` -## Try: + +### Try: ```sh play MonodyVocals.wav @@ -22,6 +25,7 @@ play MonodyVocals.wav play out.wav ``` + ## Judges' remarks: Do you need to pretend enjoying a more spacious living environment than you @@ -30,6 +34,7 @@ recording your outgoing voicemail message? Then don't waste another minute! Record yourself, send the audio file through this entry, and let your callers be surprised. + ## Author's remarks: ### Description: @@ -227,6 +232,7 @@ A few other miscellaneous obfuscations have also been done: for(s=0;s + ## To build: ```sh make ``` + ## To use: ```sh ./prog ``` -## Try: + +### Try: ```sh (./prog < fib.hs; cat prog.c) > fib.c @@ -23,10 +26,12 @@ cc fib.c -o fib ./fib ``` + ## Judges' remarks: A fully functional compiler. The example prints out the 30th Fibonacci number. + ## Author's remarks: ### Remarks: @@ -290,6 +295,7 @@ strange-looking comment. [My website reveals how this compiler works](https://crypto.stanford.edu/~blynn/compiler/ioccc.html). + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2019/mills/README.md b/2019/mills/README.md index 6d4487569..a271e8c24 100644 --- a/2019/mills/README.md +++ b/2019/mills/README.md @@ -2,12 +2,14 @@ Christopher Mills + ## To build: ```sh make ``` + ## To use: ```sh @@ -16,7 +18,8 @@ make cpclean ./prog Shakespeare.txt ``` -## Try: + +### Try: ```sh make test-64bit @@ -35,6 +38,7 @@ less Eugene_Onegin.output.txt However, as the binary model files used to produce the output are in an implementation-specific format, your mileage may vary. + ## Judges' remarks: Can a machine learn? @@ -46,6 +50,7 @@ guidelines for the IOCCC? You decide. :-) + ## Author's remarks: ### Welcome to OMLET! 🍳: @@ -662,6 +667,7 @@ The list of hyperparameters follows: [43]: https://www.fast.ai/2018/07/02/adam-weight-decay/ [44]: http://karpathy.github.io/2015/05/21/rnn-effectiveness/ + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2019/poikola/README.md b/2019/poikola/README.md index f8d48fa4b..de46b49c5 100644 --- a/2019/poikola/README.md +++ b/2019/poikola/README.md @@ -3,6 +3,7 @@ Timo Poikola\ + ## To build: ```sh @@ -10,7 +11,7 @@ make ``` -### Bugs and (Mis)features +### Bugs and (Mis)features: The current status of this entry is: @@ -33,7 +34,8 @@ sleep 86400; make clobber prog ./prog 512 ./prog ``` -## Try: + +### Try: If you don't have a few days, try: @@ -50,6 +52,7 @@ TZ=UTC48 make clobber prog This program will not validate input so it might fail or get stuck if invoked erroneously. + ## Judges' remarks: Do you have the time to see what this program does? Think again, come back and @@ -63,6 +66,7 @@ The source code layout and some of the variable names honors the ski jumping accomplishments of [Matti Nykänen](https://en.wikipedia.org/wiki/Matti_Nyk%C3%A4nen). + ## Author's remarks: ### How to build: @@ -239,6 +243,7 @@ with 224-[bit](https://en.wikipedia.org/wiki/Bit) output could take too much I would like to say _thanks_ to PSP, because there were not too many interruptions during the coding phase. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2019/yang/README.md b/2019/yang/README.md index 3cde65a51..f474b092d 100644 --- a/2019/yang/README.md +++ b/2019/yang/README.md @@ -3,12 +3,14 @@ Don Yang\ + ## To build: ```sh make ``` + ## To use: ```sh @@ -25,7 +27,8 @@ cat d cat a b c d | ./prog ``` -## Try: + +### Try: ```sh ./prog prog.c a b c d e @@ -52,11 +55,13 @@ cat a b c d e | ./prog | diff - prog.c ./prog violet.c | ruby violet.c ``` + ## Judges' remarks: Do you understand how this program works? You may have to go over and over the output again. + ## Author's remarks: ### Summary: @@ -225,6 +230,7 @@ Violet is named after [Violet Evergarden](https://en.wikipedia.org/wiki/Violet_Evergarden) in the story with the same name, the character who is highly skilled in writing letters. + ## Copyright and CC BY-SA 4.0 License: This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. diff --git a/2020/burton/README.md b/2020/burton/README.md index bbedf9650..72b8c78f9 100644 --- a/2020/burton/README.md +++ b/2020/burton/README.md @@ -3,6 +3,7 @@ Dave Burton + ## 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. diff --git a/2020/carlini/README.md b/2020/carlini/README.md index 429d26dc0..c07e2181c 100644 --- a/2020/carlini/README.md +++ b/2020/carlini/README.md @@ -3,25 +3,29 @@ Nicholas Carlini \ + ## 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 CHESSTIC-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. diff --git a/2020/endoh1/README.md b/2020/endoh1/README.md index 0ed3054df..e0caafdc8 100644 --- a/2020/endoh1/README.md +++ b/2020/endoh1/README.md @@ -4,19 +4,22 @@ Yusuke Endoh \ 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. diff --git a/2020/endoh2/README.md b/2020/endoh2/README.md index 95077d875..6fd60ebbd 100644 --- a/2020/endoh2/README.md +++ b/2020/endoh2/README.md @@ -4,19 +4,22 @@ Yusuke Endoh\ \ 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. diff --git a/2020/endoh3/README.md b/2020/endoh3/README.md index b756b0630..95d19b8c0 100644 --- a/2020/endoh3/README.md +++ b/2020/endoh3/README.md @@ -4,19 +4,22 @@ Yusuke Endoh\ \ 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. diff --git a/2020/ferguson1/README.md b/2020/ferguson1/README.md index 44930c20d..3efeae1c8 100644 --- a/2020/ferguson1/README.md +++ b/2020/ferguson1/README.md @@ -5,6 +5,7 @@ Cody Boone Ferguson \ \ 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. diff --git a/2020/ferguson2/README.md b/2020/ferguson2/README.md index 024393573..ebf77ee1a 100644 --- a/2020/ferguson2/README.md +++ b/2020/ferguson2/README.md @@ -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. diff --git a/2020/giles/README.md b/2020/giles/README.md index a695604b7..a1c79620e 100644 --- a/2020/giles/README.md +++ b/2020/giles/README.md @@ -3,19 +3,22 @@ Edward Giles\ + ## 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. diff --git a/2020/kurdyukov1/README.md b/2020/kurdyukov1/README.md index c6ea54e22..25809d182 100644 --- a/2020/kurdyukov1/README.md +++ b/2020/kurdyukov1/README.md @@ -3,19 +3,22 @@ Ilya Kurdyukov\ + ## 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. diff --git a/2020/kurdyukov2/README.md b/2020/kurdyukov2/README.md index 671a9871a..d51919696 100644 --- a/2020/kurdyukov2/README.md +++ b/2020/kurdyukov2/README.md @@ -3,19 +3,22 @@ Ilya Kurdyukov\ + ## 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. diff --git a/2020/kurdyukov3/README.md b/2020/kurdyukov3/README.md index a9641f51d..dbc3d6b6e 100644 --- a/2020/kurdyukov3/README.md +++ b/2020/kurdyukov3/README.md @@ -3,19 +3,22 @@ Ilya Kurdyukov\ + ## 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. diff --git a/2020/kurdyukov4/README.md b/2020/kurdyukov4/README.md index 9f92d3478..fcffd04fa 100644 --- a/2020/kurdyukov4/README.md +++ b/2020/kurdyukov4/README.md @@ -3,19 +3,22 @@ Ilya Kurdyukov\ + ## 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. diff --git a/2020/otterness/README.md b/2020/otterness/README.md index 6453ba766..edc9d9054 100644 --- a/2020/otterness/README.md +++ b/2020/otterness/README.md @@ -3,19 +3,22 @@ Nathan Otterness\ + ## 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. diff --git a/2020/tsoj/README.md b/2020/tsoj/README.md index ef4a04847..114e7fde7 100644 --- a/2020/tsoj/README.md +++ b/2020/tsoj/README.md @@ -3,19 +3,22 @@ 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. diff --git a/2020/yang/README.md b/2020/yang/README.md index 97baac430..5dd16bcf2 100644 --- a/2020/yang/README.md +++ b/2020/yang/README.md @@ -3,19 +3,22 @@ Don Yang\ + ## 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.