summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorThien-Thi Nguyen <ttn@gnuvola.org>2022-09-25 13:41:35 -0400
committerThien-Thi Nguyen <ttn@gnuvola.org>2022-09-25 13:41:35 -0400
commit646f35c6025804d6bd7cd197d9a3899facbdd3c2 (patch)
tree23cb1c23fec2dc4abeb814eee6634a08c3d7a9b7
parente9d5f9c669acb4c480bdf5a0575374a693fb011b (diff)
downloaddocs-646f35c6025804d6bd7cd197d9a3899facbdd3c2.tar.gz
docs-646f35c6025804d6bd7cd197d9a3899facbdd3c2.tar.bz2
docs-646f35c6025804d6bd7cd197d9a3899facbdd3c2.zip
add section "Manual Testing Database Reset" to developer manual
-rw-r--r--taler-developer-manual.rst19
1 files changed, 19 insertions, 0 deletions
diff --git a/taler-developer-manual.rst b/taler-developer-manual.rst
index 486db32..09f38b8 100644
--- 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
------------