From 0f66ae6dea47831fac55d0628a72073f88740da2 Mon Sep 17 00:00:00 2001 From: Cody Boone Ferguson <53008573+xexyl@users.noreply.github.com> Date: Fri, 21 Jun 2024 08:25:47 -0700 Subject: [PATCH] Fixes in html files of 1988 --- 1988/README.md | 15 ++++++++------- 1988/applin/README.md | 6 +++--- 1988/applin/index.html | 6 +++--- 1988/index.html | 8 ++++---- 1988/isaak/README.md | 7 +++---- 1988/isaak/index.html | 6 +++--- 1988/westley/README.md | 9 ++++++--- 1988/westley/index.html | 11 +++++++---- 8 files changed, 37 insertions(+), 31 deletions(-) diff --git a/1988/README.md b/1988/README.md index 410e54d5a..31025a95b 100644 --- a/1988/README.md +++ b/1988/README.md @@ -6,20 +6,21 @@ Look at the winning source and try to figure how it does what it does! You may then wish to look at the Author's remarks for even more details. The maximum size of entries was raised from 1024 to 1536 bytes, however smaller -entries were encouraged. Due to the ["Best Abuse of the Rules" entry of +entries were encouraged. Due to the [Best abuse of the rules entry of 1987](../1987/biggar/index.html), a limit of 160 chars in the compile line was introduced. -This year, the Grand Prize was given to the most unusual entry and best -abuse of the C Preprocessor rather than the most well rounded entry. +This year, the [Best of Show](applin/index.html) was given to the most unusual +entry and the `best abuse of the C Preprocessor` rather than the most well rounded +entry. -[Rules](rules.txt) and [results](../years.html#1988) were posted to comp.lang.c, -comp.sources.unix and alt.sources. The 1988 winning entries will be published -in the [Micro/Systems +[Rules](rules.txt) and [results](../years.html#1988) were posted to _comp.lang.c_, +_comp.sources.unix_ and _alt.sources_. The [1988 winning +entries](../years.html#1988) will be published in the [Micro/Systems Journal](https://www.vintage-computer.com/publications.php?microsystemsjournal). Winning entries for previous years were repackaged with each year being in its own directory. Makefiles and hints were also provided. -The package was posted to the comp.sources.unix newsgroup. They are +The package was posted to the _comp.sources.unix_ newsgroup. They are also available on a wide number of USENET archive sites. diff --git a/1988/applin/README.md b/1988/applin/README.md index e2c32be27..827203269 100644 --- a/1988/applin/README.md +++ b/1988/applin/README.md @@ -40,9 +40,9 @@ Dhyrstone/sec/cpu machine) using the System V `cpp`. (The GNU `cpp` when define `BIG_CPP` took only 45 seconds.) Your `cpp` may not be able to compile it due to a common bug that results in -`cpp` running out of space. The routine +`cpp` running out of space. The alternate code [zsmall](%%REPO_URL%%/1988/applin/applin.alt.c) is a smaller version -of the [applin.c](%%REPO_URL%%/1988/applin/applin.c) entry. +of the entry [applin.c](%%REPO_URL%%/1988/applin/applin.c). ## Judges' remarks: @@ -52,7 +52,7 @@ we have received thus far. Nearly all of the real work is done in the C preprocessor! When we compiled [applin.c](%%REPO_URL%%/1988/applin/applin.c) on an -[Amdahl](https://en.wikipedia.org/wiki/Amdahl_Corporation) 5890-300E, we found that it +[Amdahl 5890-300E](https://en.wikipedia.org/wiki/Amdahl_Corporation#580_series), we found that it spent over 75 minutes in the System V C preprocessor! Besides showing that the standard System V `cpp` is slow, it showed that it contained a memory usage problem. The [applin.c](%%REPO_URL%%/1988/applin/applin.c) only uses 29 different preprocessor symbols diff --git a/1988/applin/index.html b/1988/applin/index.html index ff0883e4e..6ed988c11 100644 --- a/1988/applin/index.html +++ b/1988/applin/index.html @@ -421,15 +421,15 @@ with this entry.

Dhyrstone/sec/cpu machine) using the System V cpp. (The GNU cpp when defined as BIG_CPP took only 45 seconds.)

Your cpp may not be able to compile it due to a common bug that results in -cpp running out of space. The routine +cpp running out of space. The alternate code zsmall is a smaller version -of the applin.c entry.

+of the entry applin.c.

Judges’ remarks:

This entry is by far the most unusual abuse of the C preprocessor that we have received thus far. Nearly all of the real work is done in the C preprocessor!

When we compiled applin.c on an -Amdahl 5890-300E, we found that it +Amdahl 5890-300E, we found that it spent over 75 minutes in the System V C preprocessor! Besides showing that the standard System V cpp is slow, it showed that it contained a memory usage problem. The applin.c only uses 29 different preprocessor symbols diff --git a/1988/index.html b/1988/index.html index 1f9d61eb5..163315c5e 100644 --- a/1988/index.html +++ b/1988/index.html @@ -392,14 +392,14 @@ on how to compile it and how to run the winning program. Look at the winning source and try to figure how it does what it does! You may then wish to look at the Author’s remarks for even more details.

The maximum size of entries was raised from 1024 to 1536 bytes, however smaller -entries were encouraged. Due to the “Best Abuse of the Rules” entry of +entries were encouraged. Due to the Best abuse of the rules entry of 1987, a limit of 160 chars in the compile line was introduced.

This year, the Best of Show was given to the most unusual -entry and best abuse of the C Preprocessor rather than the most well rounded +entry and the best abuse of the C Preprocessor rather than the most well rounded entry.

Rules and results were posted to comp.lang.c, -comp.sources.unix and alt.sources. The 1988 winning entries will be published -in the Micro/Systems +comp.sources.unix and alt.sources. The 1988 winning +entries will be published in the Micro/Systems Journal.

Winning entries for previous years were repackaged with each year being in its own directory. Makefiles and hints were also provided. diff --git a/1988/isaak/README.md b/1988/isaak/README.md index 06b6a0b40..7c57b84d7 100644 --- a/1988/isaak/README.md +++ b/1988/isaak/README.md @@ -69,10 +69,9 @@ from a single macro (e.g., `"O/**/O"` creates either `++` or `--` by defining NOTE: Most System V machines were not be able to execute this program correctly due to the fact that BSD style systems have an `sprintf(3)` that returns a `char *`. Due to the above problems, we placed the output of this program in the -file [isaak.output.txt](isaak.output.txt). - -Since this was fixed, this file is not strictly necessary, but we keep it for -historical purposes (decoded as it used to be uuencoded). See the +file [isaak.output.txt](isaak.output.txt). Since this was fixed, this file is +not strictly necessary, but we keep it for historical purposes (decoded as it +used to be uuencoded). See the [isaak.orig.c](%%REPO_URL%%/1988/isaak/isaak.orig.c) for the original source. FYI: We are likely to be more strict about portability in the future. diff --git a/1988/isaak/index.html b/1988/isaak/index.html index 3e163a380..808e3621a 100644 --- a/1988/isaak/index.html +++ b/1988/isaak/index.html @@ -437,9 +437,9 @@ from a single macro (e.g., "O/**/O" creates either ++ O to be + or -) may cause some strict ANSI C preprocessors to object.

NOTE: Most System V machines were not be able to execute this program correctly due to the fact that BSD style systems have an sprintf(3) that returns a char *. Due to the above problems, we placed the output of this program in the -file isaak.output.txt.

-

Since this was fixed, this file is not strictly necessary, but we keep it for -historical purposes (decoded as it used to be uuencoded). See the +file isaak.output.txt. Since this was fixed, this file is +not strictly necessary, but we keep it for historical purposes (decoded as it +used to be uuencoded). See the isaak.orig.c for the original source.

FYI: We are likely to be more strict about portability in the future.

Author’s remarks:

diff --git a/1988/westley/README.md b/1988/westley/README.md index f764ce810..c8b5b713b 100644 --- a/1988/westley/README.md +++ b/1988/westley/README.md @@ -60,19 +60,22 @@ Your compiler must parse as `--a` and not `-(-a)` or some other tokenized form. Some strictly conforming ANSI C Preprocessors may object to this: for such compilers, you can elide the non-standard token-pasting requirement -by changing the #define line to: +by changing the `#define` line to: ``` #define _ F-->00||F-OO--; ``` -This is what the modified code in [westley.c](%%REPO_URL%%/1988/westley/westley.c) does whereas the alt -code is the original. +This is what the modified code in +[westley.c](%%REPO_URL%%/1988/westley/westley.c) does whereas the alternate code +is the original. You might enjoy looking at the output of: ``` cc -E westley.alt.c + + cc -E westley.c ``` diff --git a/1988/westley/index.html b/1988/westley/index.html index 596a6f631..ef127c4c2 100644 --- a/1988/westley/index.html +++ b/1988/westley/index.html @@ -427,12 +427,15 @@ try:

as --a and not -(-a) or some other tokenized form. Some strictly conforming ANSI C Preprocessors may object to this: for such compilers, you can elide the non-standard token-pasting requirement -by changing the #define line to:

+by changing the #define line to:

    #define _ F-->00||F-OO--;
-

This is what the modified code in westley.c does whereas the alt -code is the original.

+

This is what the modified code in +westley.c does whereas the alternate code +is the original.

You might enjoy looking at the output of:

-
    cc -E westley.alt.c
+
    cc -E westley.alt.c
+
+    cc -E westley.c

Author’s remarks:

No remarks were provided by the author.