[gnunet] branch master updated: pq: -improve comments on oid-map

[gnunet]

This is an automated email from the git hooks/post-receive script.

oec pushed a commit to branch master
in repository gnunet.

The following commit(s) were added to refs/heads/master by this push:
     new 53c90532c pq: -improve comments on oid-map
53c90532c is described below

commit 53c90532c1bdb69ac2eac6a6f20581916014a91f
Author: Özgür Kesim <oec-taler@kesim.org>
AuthorDate: Sun Jul 30 09:56:19 2023 +0200

    pq: -improve comments on oid-map
---
 src/pq/pq.h | 10 +++++++---
 1 file 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;

-- 
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.