Merge pull request #88 from xexyl/readmes

README.md and Makefile files from various years

1991/buzzard/README.md

@@ -10,17 +10,17 @@
 
         make all
 
-### To run
+### To run:
 
 	./buzzard
 
-## Judges' comments
+## Judges' comments:
 
 You will be A-mazed.
 
 You are invited to try to cheat, ... if you can figure out how!  :-)
 
-## Author's comments
+## Author's comments:
 
 ### HOW TO PLAY:
 

1993/lmfjyh/Makefile

@@ -182,7 +182,9 @@ all: data ${TARGET}
 	supernova deep_magic magic charon pluto
 
 ${PROG}: ${PROG}.c
-	@echo "NOTE: This entry might not compile when using modern compilers."
+	@echo "NOTE: This will not compile when using modern compilers because"
+	@echo "it relies on a compiler bug which was fixed in gcc 2.3.3 (a very"
+	@echo "long time ago now)."
 	${RM} -f \"\;main\(\)\{puts\(\"Hello\ World!\"\)\;\}char\*C=\".c
 	${CP} lmfjyh.c \"\;main\(\)\{puts\(\"Hello\ World!\"\)\;\}char\*C=\".c
 	${CC} ${CFLAGS} \

1993/lmfjyh/README.md

@@ -9,7 +9,9 @@
 
         make all
 
-	NOTE: This entry might not compile when using modern compilers.
+NOTE: This entry will not compile on modern systems because it
+relies on a compiler bug which was fixed in gcc 2.3.3 (a very
+long time ago now).
 
 ### To run
 
@@ -17,13 +19,10 @@
 
 ## Judges' comments
     
-    See the makefile for details.
+See the Makefile for details.
 
 There's more than one way to get around disk quotas. :-)
 
-    This entry will not compile on modern systems because it
-    relies on a compiler bug which was fixed in gcc 2.3.3 (a very
-    long time ago now).
 
 ## Author's comments
 

1993/vanb/README.md

@@ -10,7 +10,12 @@
 
         make all
 
-	NOTE: This entry might not compile when using modern compilers.
+NOTE: we could not compile this entry under modern macOS but it will work
+fine under linux. It likely fails to compile under macOS because its gcc is
+actually just clang which is more strict about the type of the third
+argument of main(). If you have gcc under macOS it might work just as well.
+We did not test other systems.
+
 
 ### To run
 
@@ -36,12 +41,6 @@
 It is a good thing that this program consists of only one
 expression, otherwise it might become hard to understand.  :-)
 
-    NOTE: we could not compile this entry under modern macOS but it will work
-    fine under linux. It likely fails to compile under macOS because its gcc is
-    actually just clang which is more strict about the type of the third
-    argument of main(). If you have gcc under macOS it might work just as well.
-    We did not test other systems.
-
 ## Author's comments
 
     The program does no error checking - erroneous expressions will

1994/westley/Makefile

@@ -182,6 +182,8 @@ all: data ${TARGET}
 	supernova deep_magic magic charon pluto
 
 ${PROG}: ${PROG}.c
+	@echo "NOTE: this entry has different compiler errors based on compilation line."
+	@echo "The purpose is to find the right error message to win the game!"
 	-${CC} ${CFLAGS} $< -o $@ ${LIBS}
 
 # alternative executable

1994/westley/README.md

@@ -10,6 +10,11 @@
 
         make all
 
+NOTE: the purpose of this entry is to escape the dungeon via the compiler line
+where you get messages as compiler errors. Depending on the compiler line you
+will get different error messages and one compiler line will make you win the
+game!
+
 ### To run
 
 	./westley

1996/dalbec/README.md

@@ -13,25 +13,27 @@
 
 NOTE: This entry uses non-standard args to main() that do not work with modern compilers.
 
-### To run
+## To run:
 
 	./dalbec
 
-## Judges' comments
+## Try:
 
-    The output is mis-leading ... why does it also print 2047?
-
-    Also try:
 
 	./dalbec 3
 
-    why does it output 121?
+Why does it output 121?
 
-    For a hint see:
 
-	http://www.utm.edu/research/primes/prove2.html#sprp
+## Judges' comments:
 
-    and then try to understand the source!  :-)
+The output is mis-leading ... why does it also print 2047?
+
+For a hint see
+[https://web.archive.org/web/20000510191341/https://www.utm.edu/research/primes/prove2.html](https://web.archive.org/web/20000510191341/https://www.utm.edu/research/primes/prove2.html).
+
+
+... and then try to understand the source!  :-)
 
 We (the judges) recommend that you take the time needed to understand
 how this program works.  The source is small enough to make the effort
@@ -52,20 +54,21 @@
 
 On completion, the program produces a core file that may be used to
 refine this estimate.  (Or you could try typing "limit" if you're
-    running csh.) In rare cases the stack space may exceed 24*MAXINT
+running `csh`.) In rare cases the stack space may exceed `24*MAXINT`
 bytes, in which case the program will produce an inaccurate estimate.
 
 This program is obfuscated:
 
-    (1) by the use of easily-confused variable names
+1. by the use of easily-confused variable names
 
-    (2) by using the implicit !=0 in conditional expressions
+2. by using the implicit !=0 in conditional expressions
 
-    (3) by substituting expressions such as !a for 0 where a!=0
+3. by substituting expressions such as !a for 0 where a!=0 and !a for 1 where a==0
-                                        and !a for 1 where a==0
 
-    (4) by the fact that main() is a single expression and so beautifies poorly
+4. by the fact that main() is a single expression and so beautifies poorly
 
-    (5) by the fact that main() is used
+5. by the fact that main() is used
-        (a) to compute powers in modular arithmetic
+
-        (b) to recursively call itself in the main loop
+    - to compute powers in modular arithmetic
+
+    - to recursively call itself in the main loop

1996/eldby/README.md

@@ -22,5 +22,5 @@
 ## Author's comments
 
 This program shows flying spheres. The program eats CPU on lesser
-    equipt systems. The program will run until termination. Terminal 
+equipped systems. The program will run until termination. Terminal 
 must be vt100 or better with 80 columns and 24 rows or more.

1996/huffman/README.md

@@ -12,17 +12,19 @@
 
         make all
 
-### To run
+### To run:
+
 
 	echo 'Huffman Decoding' | ./huffman
 
-## Judges' comments
+## Try: 
-
-    Try: 
 
 	echo 'seeing or feeling is believing' | ./huffman
 	echo 'CC OR NOT CC' | ./huffman | ./huffman
 
+
+## Judges' comments:
+
 If you are still confused and want to read a spoiler, check out
 the source and it will be clear as mud!
 
@@ -34,7 +36,7 @@
 
 This entry was very well received at the IOCCC BOF.
 
-## Author's comments
+## Author's comments:
 
 This filter program is really not obfuscated code.  It compiles cleanly
 with an ANSI C compiler and comes with user documentation that even a

1996/jonth/README.md

@@ -16,18 +16,19 @@
 
 	./jonth
 
-## Judges' comments
+## Try:
-
-    Also try:
 
 	./jonth host1:0 host2:0
 
+## Judges' comments
+
+
     For extra credit, figure out how you can cheat by taking over
     a square already occupied by an opponent.
 
 ## Author's comments
 
-    This is mulituser tictactoe for X Windows. You may give one or two X
+This is multi-user tic-tac-toe for X Windows. You may give one or two X
 displays as arguments to this game.
 
 Known bugs:

1996/rcm/README.md

@@ -9,16 +9,19 @@
 
         make all
 
-### To run
+### To run:
 
 	./rcm < rfc1951.gz
 
-## Judges' comments
+## Try:
 
-    And for more information try:
+For more information try:
 
 	./rcm < rfc1952.gz
 
+
+## Judges' comments
+
 For a good noop try:
 
 	gzip -c < rcm.c | ./rcm