commit a3a317d2dfdb47ad07017e2f99ce051f9b001ffc
from: Sven M. Hallberg <pesco@khjk.org>
date: Sun May 25 09:50:47 2025 UTC

manpage tweaks

commit - 101dd348a5859c78ec62ef2388cb675ff8a6db3d
commit + a3a317d2dfdb47ad07017e2f99ce051f9b001ffc
blob - ff3863eca702df7bc6c4b4266889bdd512d5d8f9
blob + 9e7aa74f656e35decd920eeadd0d8fe6e441ee25
--- exercise.1
+++ exercise.1
@@ -1,4 +1,4 @@
-.Dd May 11, 2025
+.Dd May 25, 2025
 .Dt EXERCISE 1
 .Os
 .
@@ -35,16 +35,16 @@ The options are as follows:
 When searching for tests,
 only descend into directories that match the given pattern.
 Defaults to
-.Dq *
+.Sq *
 (all directories).
 .It Fl p Sy s= Ns Ar pattern
 Process (only) files matching the given pattern as test suites.
 Defaults to
-.Dq *.tests .
+.Sq *.tests .
 .It Fl p Sy t= Ns Ar pattern
 Process (only) files matching the given pattern as tests.
 Defaults to
-.Dq *.t .
+.Sq *.t .
 .It Fl q
 Do not print status counters to standard output.
 .El
@@ -52,10 +52,12 @@ Do not print status counters to standard output.
 .Ss Test Files
 Tests are represented simply as executable files that are expected to exit 0 on
 success.
-Any output to standard error and non-zero exits are interpreted as negative
-results (test failures).
+Non-zero exits as well as any output to standard error
+are interpreted as negative results (failure).
 Standard output is ignored.
-As a special case, exit status 127 is interpreted as an error during the test,
+.Pp
+As a special case, exit status 127 is interpreted as an error
+that precluded the proper execution of the test,
 implying an inconclusive result.
 .
 .Ss Test Suites
@@ -63,14 +65,15 @@ Multiple tests can be combined into one executable.
 A test suite should pass error messages from individual tests unchanged to its
 standard error.
 Its exit status should indicate whether all tests passed.
-A test suite should only exit 127 if there was an error executing the suite
-itself.
-Errors within individual tests should be reported normally.
 .Pp
+A test suite should only exit 127 if there was a fatal issue in executing
+the suite itself.
+Errors among the individual tests should be reported through the
+status counters as detailed below.
+.Pp
 The standard output from a
-.Dq test suite
-executable should consist of lines of the form
-.Dq run N ok N fail N error N ,
+test suite executable should consist of lines of the form
+.Sq run Va n No ok Va m No fail Va l No error Va k No ,
 representing running counts as printed by
 .Nm
 itself.