From 646f35c6025804d6bd7cd197d9a3899facbdd3c2 Mon Sep 17 00:00:00 2001 From: Thien-Thi Nguyen Date: Sun, 25 Sep 2022 13:41:35 -0400 Subject: add section "Manual Testing Database Reset" to developer manual --- taler-developer-manual.rst | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/taler-developer-manual.rst b/taler-developer-manual.rst index 486db321..09f38b87 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 ------------ -- cgit v1.2.3