pq: -improve comments on oid-map

1 files changed, 7 insertions, 3 deletions

diff --git a/src/pq/pq.h b/src/pq/pq.h
index 46d749fcc..65b72cedd 100644
--- a/src/pq/pq.h
+++ b/src/pq/pq.h
@@ -100,16 +100,20 @@ struct GNUNET_PQ_Context
   enum GNUNET_PQ_Options flags;
 
   /**
-   * Mapping between array types and Oid's, filled at reconnect
+   * Mapping between array types and Oid's, pre-filled at reconnect.
+   * More entries are captured in via GNUNET_PQ_get_oid_by_name.
    */
   struct
   {
-    /* allocated number of elements array @table */
+    /* Allocated number of elements array the table */
     unsigned int cap;
 
-    /* number of entries in @table */
+    /* Number of entries in the table */
     unsigned int num;
 
+    /* The table of (name, oid) pairs.
+     * Note that the names are 'const char *' and the pointers should be point
+     * to the same string throughout the lifetime of the program.*/
     struct name2oid
     {
       const char *name;