From 748e3504a07471f67bbbb3540785777930314ef1 Mon Sep 17 00:00:00 2001
From: Landon Curt Noll <github-mail@asthe.com>
Date: Mon, 23 Jun 2025 23:02:46 -0700
Subject: [PATCH] add improved try and try.alt rules to next/Makefile.example

---
 next/Makefile.example | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/next/Makefile.example b/next/Makefile.example
index 3a45f7e55..0564aba85 100644
--- a/next/Makefile.example
+++ b/next/Makefile.example
@@ -196,6 +196,16 @@ all: data ${TARGET}
 ${PROG}: ${PROG}.c
 	${CC} ${CFLAGS} ${PROG}.c -o $@ ${LDFLAGS}
 
+# suggested way(s) to run the program
+#
+# XXX - You are better off supplying a try.sh script, than using a try Makefile rule.
+#
+# XXX - If you have a try.sh script, then please remove this try rule from your Makefile
+#
+try: ${PROG} ${DATA}
+	@# XXX - change this next line as needed
+	./${PROG} XXX some arguments XXX
+
 # alternative executable
 #
 alt: data ${ALT_TARGET}
@@ -204,6 +214,18 @@ alt: data ${ALT_TARGET}
 ${PROG}.alt: ${PROG}.alt.c
 	${CC} ${CFLAGS} ${PROG}.alt.c -o $@ ${LDFLAGS}
 
+# suggested way(s) to run alt code, if you include a prog.alt.c
+#
+# XXX - You are better off supplying a try.sh script, than using a try Makefile rule.
+#
+# XXX - If you have a try.sh script, then please remove this try.alt rule
+#
+# XXX - If you do NOT have a prog.alt.c, then please remove this try.alt rule from your Makefile
+#
+try.alt: ${PROG}.alt ${DATA}
+	@# XXX - change this next line as needed
+	./${PROG}.alt XXX some arguments XXX
+
 # data files
 #
 data: ${DATA}