From 8446ba1ae0154ba1dea264c89912e83ecea98a00 Mon Sep 17 00:00:00 2001
From: jmallett <jmallett@FreeBSD.org>
Date: Mon, 24 Jun 2002 13:58:20 +0000
Subject: Comments to describe what these macros do, so that someone other than
 me might be able to figure out how to write some of these tests (hint hint).

---
 tools/regression/usr.bin/regress.m4 | 13 +++++++++++++
 1 file changed, 13 insertions(+)

(limited to 'tools')

diff --git a/tools/regression/usr.bin/regress.m4 b/tools/regression/usr.bin/regress.m4
index ff25c2c..be5cc61 100644
--- a/tools/regression/usr.bin/regress.m4
+++ b/tools/regression/usr.bin/regress.m4
@@ -1,5 +1,10 @@
 # $FreeBSD$
 
+dnl A library of routines for doing regression tests for userland utilities.
+
+dnl Start up.  We initialise the exit status to 0 (no failure) and change
+dnl into the directory specified by our first argument, which is the
+dnl directory to run the tests inside.
 define(`REGRESSION_START',
 TESTDIR=$1
 if [ -z "$TESTDIR" ]; then
@@ -9,6 +14,10 @@ cd $TESTDIR
 
 STATUS=0)
 
+dnl An actual test.  The first parameter is the test name.  The second is the
+dnl command/commands to execute for the actual test.  Their exit status is
+dnl checked.  It is assumed that the test will output to stdout, and that the
+dnl output to be used to check for regression will be in regress.TESTNAME.out.
 define(`REGRESSION_TEST',
 echo "Running test $1"
 $2 | diff -u regress.$1.out -
@@ -19,5 +28,9 @@ else
   echo "FAIL: Test $1 failed: regression detected.  See above."
 fi)
 
+dnl Cleanup.  Exit with the status code of the last failure.  Should probably
+dnl be the number of failed tests, but hey presto, this is what it does.  This
+dnl could also clean up potential droppings, if some forms of regression tests
+dnl end up using mktemp(1) or such.
 define(`REGRESSION_END',
 exit $STATUS)
-- 
cgit v1.1