From 886233aea7481b00676059064cd4a56187b32478 Mon Sep 17 00:00:00 2001
From: Damian Rouson <rouson@lbl.gov>
Date: Sat, 28 Dec 2024 14:46:22 -0500
Subject: [PATCH] doc(test-termination): update README.md

---
 test-termination/README.md | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/test-termination/README.md b/test-termination/README.md
index db3bcb7c..3af011b3 100644
--- a/test-termination/README.md
+++ b/test-termination/README.md
@@ -6,3 +6,32 @@ procedures and interface from  prif.F90:
   - `prif_register_stop_callback`
   - `prif_stop_callback_interface`
   - `prif_stop`
+
+Usage
+-----
+To build or rebuild and run the tests in this subdirectory, execute the following
+commands:
+```
+fpm clean --all
+cd ..
+./install.sh
+cd - 
+mkdir build
+cp ../build/run-fpm.sh build
+../build/run-fpm.sh test
+```
+which should yield trailing output similar to the following:
+```
+ ERROR STOP 'USER_PROVIDED_STRING'
+ callback invoked
+ STOP
+ STOP 'USER_PROVIDED_STRING'
+ STOP           99
+ STOP
+<ERROR> Execution for object " error_stop_with_character_code " returned exit code  1
+<ERROR> Execution for object " error_stop_with_integer_code " returned exit code  100
+<ERROR> Execution for object " error_stop_with_no_code " returned exit code  1
+<ERROR> Execution for object " stop_with_integer_code " returned exit code  99
+<ERROR> *cmd_run*:stopping due to failed executions
+STOP 1
+```