exchange

commit fb124841605dabe843f4d5713e58a516ddc84d48
parent 1466048e4d19a198a33d1f224dbb5a25fa42b9c2
Author: Christian Grothoff <christian@grothoff.org>
Date:   Wed, 28 Jan 2015 22:35:57 +0100

update docu

Diffstat:
M
src/mint/mint_db.c
 | 
9
++++++++-
M
src/mint/mint_db.h
 | 
4
++--
M
src/mint/taler-mint-httpd_db.c
 | 
4
+++-
M
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
@@ -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
@@ -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
@@ -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
@@ -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