doc: Update documentation

diff --git a/doc/users/testsuite.html b/doc/users/testsuite.html
index 66bc8af3da728a45c96b759234d9d3c12c316dfd..d6fef94645cec845e0d763096e2589bbe276cb0e 100644 (file)
--- a/doc/users/testsuite.html
+++ b/doc/users/testsuite.html
@@ -148,6 +148,17 @@ Test project .../examples/step-1
 Total Test time (real) =   1.72 sec</pre>
     </p>
 
+    <p>
+      <i>Remark:</i> If the parameter file ends in <code>.prm.in</code>
+      instead of <code>.prm</code>, it will be configured/preprocessed to a
+      test.prm file. This is done with the CMake macro
+      <code>CONFIGURE_FILE</code> that replaces all strings
+      <code>@VARIABLE@</code> with the contents of the corresponding CMake
+      variable. This is useful in particular to conveniently substitute
+      <code>@SOURCE_DIR@</code> with the full source directory path of the
+      test.
+    </p>
+
     <p>
       <i>Remark:</i> The test driver will compare the combined output
       stream of stdout and stderr against the comparison file. If the test