From fb124841605dabe843f4d5713e58a516ddc84d48 Mon Sep 17 00:00:00 2001
From: Christian Grothoff <christian@grothoff.org>
Date: Wed, 28 Jan 2015 22:35:57 +0100
Subject: update docu

---
 src/mint/mint_db.c             | 9 ++++++++-
 src/mint/mint_db.h             | 4 ++--
 src/mint/taler-mint-httpd_db.c | 4 +++-
 src/mint/taler-mint-httpd_db.h | 2 +-
 4 files changed, 14 insertions(+), 5 deletions(-)

diff --git a/src/mint/mint_db.c b/src/mint/mint_db.c
index dcde03dc1..b23a5b65f 100644
--- a/src/mint/mint_db.c
+++ b/src/mint/mint_db.c
@@ -15,8 +15,15 @@
 */
 /**
  * @file mint_db.c
- * @brief Database access for the mint
+ * @brief Low-level (statement-level) database access for the mint
  * @author Florian Dold
+ * @author Christian Grothoff
+ *
+ * TODO:
+ * - The mint_db.h-API should ideally be what we need to port
+ *   when using other databases; so here we should enable
+ *   alternative implementations by returning
+ *   a more opaque DB handle.
  */
 #include "platform.h"
 #include "db_pq.h"
diff --git a/src/mint/mint_db.h b/src/mint/mint_db.h
index 6e1fb4753..01fd737bd 100644
--- a/src/mint/mint_db.h
+++ b/src/mint/mint_db.h
@@ -13,11 +13,11 @@
   You should have received a copy of the GNU General Public License along with
   TALER; see the file COPYING.  If not, If not, see <http://www.gnu.org/licenses/>
 */
-
 /**
  * @file mint/mint_db.h
- * @brief Mint-specific database access
+ * @brief Low-level (statement-level) database access for the mint
  * @author Florian Dold
+ * @author Christian Grothoff
  */
 
 #ifndef _NEURO_MINT_DB_H
diff --git a/src/mint/taler-mint-httpd_db.c b/src/mint/taler-mint-httpd_db.c
index 6dffbcd63..7e9dde849 100644
--- a/src/mint/taler-mint-httpd_db.c
+++ b/src/mint/taler-mint-httpd_db.c
@@ -15,11 +15,13 @@
 */
 /**
  * @file taler-mint-httpd_db.c
- * @brief Database access abstraction for the mint.
+ * @brief High-level (transactional-layer) database operations for the mint.
  * @author Christian Grothoff
  *
  * TODO:
  * - actually abstract DB implementation (i.e. via plugin logic)
+ *   (this file should remain largely unchanged with the exception
+ *    of the PQ-specific DB handle types)
  * - /deposit: properly check existing deposits
  * - /deposit: properly perform commit (check return value)
  * - /deposit: check for leaks
diff --git a/src/mint/taler-mint-httpd_db.h b/src/mint/taler-mint-httpd_db.h
index a5c195317..54d2aab34 100644
--- a/src/mint/taler-mint-httpd_db.h
+++ b/src/mint/taler-mint-httpd_db.h
@@ -15,7 +15,7 @@
 */
 /**
  * @file mint/taler-mint_httpd_db.h
- * @brief Mint-specific database access
+ * @brief High-level (transactional-layer) database operations for the mint
  * @author Chrisitan Grothoff
  */
 #ifndef TALER_MINT_HTTPD_DB_H
-- 
cgit v1.2.3