Mercurial > luadbi / file diff

--- a/dbd/postgresql/dbd_postgresql.h	Sun Nov 23 01:29:09 2008 +0000
+++ b/dbd/postgresql/dbd_postgresql.h	Sun Nov 23 04:12:04 2008 +0000
@@ -3,20 +3,30 @@
 #include <catalog/pg_type.h>
 #include <dbd/common.h>
 
+/* 
+ * length of a prepared statement ID
+ * \d{17}\0
+ */
 #define IDLEN 18
 
 #define DBD_POSTGRESQL_CONNECTION   "DBD.PostgreSQL.Connection"
 #define DBD_POSTGRESQL_STATEMENT    "DBD.PostgreSQL.Statement"
 
+/*
+ * connection object implentation
+ */
 typedef struct _connection {
     PGconn *postgresql;
-    unsigned int statement_id;
+    unsigned int statement_id; /* sequence for statement IDs */
 } connection_t;
 
+/*
+ * statement object implementation
+ */
 typedef struct _statement {
     PGconn *postgresql;
     PGresult *result;
-    char name[IDLEN];
-    int tuple;
+    char name[IDLEN]; /* statement ID */
+    int tuple; /* number of rows returned */
 } statement_t;