Add 1992/gson/try.sh, add note about optimiser

The optimiser must be disabled due to it otherwise crashing in macOS in
some invocations. This has been added to the Makefile, the use of -O0 is
forced and a note has been added to the README.md file.

The bugs.md file has been updated on details of how it uses gets() and
that text has been removed from the thanks file.

Minor format fixes in README.md.

The script added makes use of the author's script (that I added as
mkdict.sh for easier use) after first trying to find a dictionary file.
But one can override the dictionary file with the DICT environmental
variable.

This entry should now truly be done.

1992/gson/Makefile

@@ -42,7 +42,7 @@ CSILENCE= -Wno-bitwise-op-parentheses -Wno-char-subscripts \
 	-Wno-deprecated-declarations -Wno-empty-body -Wno-error \
 	-Wno-implicit-function-declaration -Wno-parentheses -Wno-pedantic \
 	-Wno-return-type -Wno-unused-parameter -Wno-unused-value \
-	-Wno-deprecated-non-prototype
+	-Wno-deprecated-non-prototype -Wno-implicit-int
 
 # Common C compiler warning flags
 #
@@ -69,7 +69,9 @@ CINCLUDE=
 
 # Optimization
 #
-OPT=
+# We DISABLE the optimiser because having it enabled will cause a crash in some
+# invocations in some systems.
+OPT= -O0
 
 # Default flags for ANSI C compilation
 #
@@ -133,8 +135,11 @@ all: data ${TARGET}
 	clean clobber install love haste waste maker easter_egg \
 	sandwich supernova deep_magic magic charon pluto
 
+# We DISABLE THE OPTIMISER because when it's enabled in some conditions it
+# crashes.
+#
 ${PROG}: ${PROG}.c
-	${CC} ${CFLAGS} $< -o $@ ${LDFLAGS}
+	${CC} ${CFLAGS} -O0 $< -o $@ ${LDFLAGS}
 
 ag: ${PROG}
 	${RM} -f $@

1992/gson/README.md

@@ -4,6 +4,10 @@
 make all
 ```
 
+NOTE: we DISABLE the optimiser because having it enabled causes some invocations
+to crash in some systems.
+
+
 ### Bugs and (Mis)features:
 
 The current status of this entry is:
@@ -127,13 +131,14 @@ Instead, it tries to achieve both its speed and its obscurity through a
 careful choice of algorithms.  Some of the finer points of those
 algorithms are outlined in the spoiler below.
 
+
 ### How it works:
 
 Here follows a description of some of the data structures and
 algorithms used by AG.  It is by no means complete, but it may help
 you get an idea about the general principles.
 
---
+---
 
 Internally, AG represents words and sentences as arrays of 32
 4-bit integer elements.  Each element represents the number of

1992/gson/try.sh

@@ -0,0 +1,123 @@
+#!/usr/bin/env bash
+#
+# try.sh - demonstrate IOCCC winner 1992/gson
+#
+
+# make sure CC is set so that when we do make CC="$CC" it isn't empty. Doing it
+# this way allows us to have the user specify a different compiler in an easy
+# way.
+if [[ -z "$CC" ]]; then
+    CC="cc"
+fi
+
+make CC="$CC" all >/dev/null || exit 1
+
+# clear screen after compilation so that only the entry is shown
+clear
+
+# attempt to find a dictionary file if DICT unset or not a regular readable file
+#
+if [[ -z "$DICT" || ! -f "$DICT" || ! -r "$DICT" ]]; then
+    DICT="/usr/share/dict/words"
+
+    if [[ ! -r "$DICT" ]]; then
+	DICT="/usr/share/lib/spell/words"
+
+	if [[ ! -r "$DICT" ]]; then
+	    DICT="/usr/ucblib/dict/words"
+	    
+	    if [[ ! -r "$DICT" ]]; then
+		DICT="/dev/null"
+	    fi
+	fi
+    fi
+fi
+
+# safety check that DICT is not empty and is a readable file
+#
+if [[ -z "$DICT" || ! -f "$DICT" || ! -r "$DICT" ]]; then
+    echo "No dictionary file found, try specifying one like:" 1>&2
+    echo 1>&2
+    echo "  DICT=dict ./try.sh" 1>&2
+    echo 1>&2
+    exit 1
+fi
+
+echo "$ ./ag free software foundation < $DICT" 1>&2
+read -r -n 1 -p "Press any key to continue (space = next page, q = quit): "
+echo 1>&2
+./ag free software foundation < "$DICT" 2>/dev/null | less -rEXF
+
+echo "$ ./ag obfuscated c contest < $DICT" 1>&2
+read -r -n 1 -p "Press any key to continue (space = next page, q = quit): "
+echo 1>&2
+./ag obfuscated c contest < "$DICT" 2>/dev/null | less -rEXF
+
+echo "$ ./ag unix international	< $DICT" 1>&2
+read -r -n 1 -p "Press any key to continue (space = next page, q = quit): "
+echo 1>&2
+./ag unix international	< "$DICT" 2>/dev/null | less -rEXF
+
+echo "$ ./ag george bush < $DICT" 1>&2
+read -r -n 1 -p "Press any key to continue (space = next page, q = quit): "
+echo 1>&2
+./ag george bush < "$DICT" 2>/dev/null | less -rEXF
+
+echo "$ ./ag bill clinton < $DICT" 1>&2
+read -r -n 1 -p "Press any key to continue (space = next page, q = quit): "
+echo 1>&2
+./ag bill clinton < "$DICT" 2>/dev/null | less -rEXF
+
+echo "$ ./ag ross perot	< $DICT" 1>&2
+read -r -n 1 -p "Press any key to continue (space = next page, q = quit): "
+echo 1>&2
+./ag ross perot	< "$DICT" 2>/dev/null | less -rEXF
+
+echo "$ ./ag paul e tsongas < $DICT" 1>&2
+read -r -n 1 -p "Press any key to continue (space = next page, q = quit): "
+echo 1>&2
+./ag paul e tsongas < "$DICT" 2>/dev/null | less -rEXF
+
+# now try making our own dictionary with mkdict.sh:
+#
+rm -f words
+cat README.md try.sh Makefile | ./mkdict.sh > words
+DICT="words"
+
+read -r -n 1 -p "Press any key to use our own dict from mkdict.sh: "
+echo 1>&2
+
+echo "$ ./ag free software foundation < $DICT" 1>&2
+read -r -n 1 -p "Press any key to continue (space = next page, q = quit): "
+echo 1>&2
+./ag free software foundation < "$DICT" 2>/dev/null | less -rEXF
+
+echo "$ ./ag obfuscated c contest < $DICT" 1>&2
+read -r -n 1 -p "Press any key to continue (space = next page, q = quit): "
+echo 1>&2
+./ag obfuscated c contest < "$DICT" 2>/dev/null | less -rEXF
+
+echo "$ ./ag unix international	< $DICT" 1>&2
+read -r -n 1 -p "Press any key to continue (space = next page, q = quit): "
+echo 1>&2
+./ag unix international	< "$DICT" 2>/dev/null | less -rEXF
+
+echo "$ ./ag george bush < $DICT" 1>&2
+read -r -n 1 -p "Press any key to continue (space = next page, q = quit): "
+echo 1>&2
+./ag george bush < "$DICT" 2>/dev/null | less -rEXF
+
+echo "$ ./ag bill clinton < $DICT" 1>&2
+read -r -n 1 -p "Press any key to continue (space = next page, q = quit): "
+echo 1>&2
+./ag bill clinton < "$DICT" 2>/dev/null | less -rEXF
+
+echo "$ ./ag ross perot	< $DICT" 1>&2
+read -r -n 1 -p "Press any key to continue (space = next page, q = quit): "
+echo 1>&2
+./ag ross perot	< "$DICT" 2>/dev/null | less -rEXF
+
+echo "$ ./ag paul e tsongas < $DICT" 1>&2
+read -r -n 1 -p "Press any key to continue (space = next page, q = quit): "
+echo 1>&2
+./ag paul e tsongas < "$DICT" 2>/dev/null | less -rEXF