From 4db6c8994bee7856d6f5b5d06788ad275b89c9d5 Mon Sep 17 00:00:00 2001 From: Cody Boone Ferguson <53008573+xexyl@users.noreply.github.com> Date: Mon, 13 Mar 2023 10:11:02 -0700 Subject: [PATCH] Many README.md fixes and some Makefile fixes The years 1984, 1985 and 1986 have had all winning entry README.md files updated. This includes formatting, adding author's comments (which in these years means nothing but still have the section there to indicate that there were no comments) and possibly other things. I have updated some - not all - of the 1987 winning entry README.md files. I have to do other things now but I want these committed. I will work on the other README.md files another time. --- 1984/anonymous/README.md | 4 ++++ 1984/decot/Makefile | 6 +++++- 1984/decot/README.md | 4 ++++ 1984/laman/README.md | 24 ++++++++++++++++-------- 1984/mullender/README.md | 8 +++++++- 1985/applin/README.md | 4 ++++ 1985/august/README.md | 5 +++++ 1985/lycklama/README.md | 5 +++++ 1985/shapiro/README.md | 5 +++++ 1985/sicherman/Makefile | 5 ++++- 1985/sicherman/README.md | 5 +++++ 1986/applin/README.md | 5 +++++ 1986/august/README.md | 5 +++++ 1986/bright/README.md | 10 ++++++++++ 1986/hague/README.md | 5 +++++ 1986/holloway/Makefile | 1 + 1986/holloway/README.md | 7 ++++++- 1986/pawka/README.md | 4 ++++ 1986/stein/README.md | 5 +++++ 1987/biggar/README.md | 20 +++++++++++++++----- 1987/heckbert/README.md | 5 +++++ 1987/hines/README.md | 5 +++++ 1987/lievaart/README.md | 19 ++++++++++++++++++- 23 files changed, 148 insertions(+), 18 deletions(-) diff --git a/1984/anonymous/README.md b/1984/anonymous/README.md index 73f0100e1..5155cdff0 100644 --- a/1984/anonymous/README.md +++ b/1984/anonymous/README.md @@ -53,6 +53,10 @@ If we add to the CFLAGS `-include unistd.h` we will run into another problem: ssize_t read(int, void *, size_t) __DARWIN_ALIAS_C(read); ^ +## Author's comments: + +No comments were provided by the author. + Copyright (c) 1984, Landon Curt Noll. All Rights Reserved. Permission for personal, educational or non-profit use is diff --git a/1984/decot/Makefile b/1984/decot/Makefile index e88641dc8..f8bfad024 100644 --- a/1984/decot/Makefile +++ b/1984/decot/Makefile @@ -94,7 +94,7 @@ ARCH= # Defines that are needed to compile # -CDEFINE= -traditional-cpp +CDEFINE= #CDEFINE= -DIOCCC=26 # Include files that are needed to compile @@ -172,6 +172,10 @@ TARGET= ${PROG} ALT_OBJ= ALT_TARGET= +# FORCE use of -traditional-cpp +# +CFLAGS+= -traditional-cpp + ################# # build the entry diff --git a/1984/decot/README.md b/1984/decot/README.md index c648fadd9..88287c2f8 100644 --- a/1984/decot/README.md +++ b/1984/decot/README.md @@ -31,6 +31,10 @@ This program prints out a string of garbage. The judges also offer this one comment: understand comments! +## Author's comments: + +No comments were provided by the author. + Copyright (c) 1984, Landon Curt Noll. All Rights Reserved. Permission for personal, educational or non-profit use is diff --git a/1984/laman/README.md b/1984/laman/README.md index b9b5e389b..71caffee8 100644 --- a/1984/laman/README.md +++ b/1984/laman/README.md @@ -10,6 +10,19 @@ Mike Laman ./laman +## Try: + +The program accepts ONE positive argument. Seeing is believing, so try things +like: + + ./laman 4 + ./laman 9 + ./laman 16 + +This code should run you in circles. + +NOTE: this program will likely segfault if you do not provide an argument and it +will not print anything if the number is not positive or not a number. ## Judges' comments: @@ -24,17 +37,12 @@ to: ;++f)a[ b<<5|c] =d++,b+= e;for( f=0;f FYI: We will let Mark get away with this truly sick entry this time, but > for the future on we have placed a limit on the size of a compile line. -Also see our comment in Larry Wall's entry regarding Mark's contribution. +Also see our comment in [Larry Wall's entry](../wall/README.md) regarding Mark's contribution. + +## Judges' comments: + +Passes BSD and UTS lint. At least one version of lint is thrown into +an infinite loop by this entry. + + +## Author's comments: + +No comments were provided by the author. + Copyright (c) 1987, Landon Curt Noll & Larry Bassel. All Rights Reserved. Permission for personal, educational or non-profit use is diff --git a/1987/heckbert/README.md b/1987/heckbert/README.md index 71024f9d8..7fe2c4d10 100644 --- a/1987/heckbert/README.md +++ b/1987/heckbert/README.md @@ -35,6 +35,11 @@ Try not to files. :-) +## Author's comments: + +No comments were provided by the author. + + The judges used this program to fold up very long lines which the BSD fold(1) was unable to process. This program has been added to the contest tool chest. diff --git a/1987/hines/README.md b/1987/hines/README.md index 9ae9c4d64..0d05ee191 100644 --- a/1987/hines/README.md +++ b/1987/hines/README.md @@ -38,6 +38,11 @@ We consider this to be a beautiful counter-example for Frank Rubin's letter to ACM form titled: _"'GOTO Considered Harmful' Considered Harmful"_. See the Communications of the ACM, March 1987, Page 195-196. + +## Author's comments: + +No comments were provided by the author. + Copyright (c) 1987, Landon Curt Noll & Larry Bassel. All Rights Reserved. Permission for personal, educational or non-profit use is granted provided this this copyright and notice are included in its entirety diff --git a/1987/lievaart/README.md b/1987/lievaart/README.md index f713b9584..abfa133b3 100644 --- a/1987/lievaart/README.md +++ b/1987/lievaart/README.md @@ -9,7 +9,19 @@ Amsterdam, The Netherlands make all -NOTE: The original entry may be built with "make alt". +NOTE: The original entry may be built with "make alt" if you have an old enough +compiler. + +## To run: + + ./lievaart + # enter a level and start playing as described below + + ./lievaart2 + # enter a level and start playing as described below + +NOTE: if you enter invalid input the program will enter an infinite loop +displaying a string like `"You:"` repeatedly. ## Judges' remarks: @@ -35,6 +47,11 @@ program. The file lievaart2.c contains what the program would have been without the size restriction. This version has the full end game logic and displays the board after each move! + +## Author's comments: + +No comments were provided by the author. + Copyright (c) 1987, Landon Curt Noll & Larry Bassel. All Rights Reserved. Permission for personal, educational or non-profit use is granted provided this this copyright and notice are included in its entirety