commit 646f35c6025804d6bd7cd197d9a3899facbdd3c2
parent e9d5f9c669acb4c480bdf5a0575374a693fb011b
Author: Thien-Thi Nguyen <ttn@gnuvola.org>
Date: Sun, 25 Sep 2022 13:41:35 -0400
add section "Manual Testing Database Reset" to developer manual
Diffstat:
1 file changed, 19 insertions(+), 0 deletions(-)
diff --git a/taler-developer-manual.rst b/taler-developer-manual.rst
@@ -49,6 +49,25 @@ For full ``make check`` support, install these programs:
The ``make check`` should be able to function without them, but
their presence permits some tests to run that would otherwise be skipped.
+Manual Testing Database Reset
+-----------------------------
+
+Sometimes ``make check`` will fail with some kind of database (SQL)
+error, perhaps with a message like ``OBJECT does not exist`` in the
+``test-suite.log`` file, where ``OBJECT`` is the name of a table or function.
+In that case, it may be necessary to reset the ``talercheck`` database
+with the commands:
+
+.. code-block:: console
+
+ $ dropdb talercheck
+ $ createdb talercheck
+
+This is because, at the moment, there is no support for
+doing these steps automatically in the ``make check`` flow.
+
+(If ``make check`` still fails after the reset, file a bug report as usual.)
+
Bug Tracking
------------
