update docu

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"

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

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

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