[GNUnet-SVN] r22436 - gnunet/src/include

[gnunet]

Author: grothoff
Date: 2012-07-02 15:25:03 +0200 (Mon, 02 Jul 2012)
New Revision: 22436

Modified:
   gnunet/src/include/gnunet_namestore_service.h
Log:
-update docu

Modified: gnunet/src/include/gnunet_namestore_service.h
===================================================================
--- gnunet/src/include/gnunet_namestore_service.h       2012-07-02 13:23:12 UTC 
(rev 22435)
+++ gnunet/src/include/gnunet_namestore_service.h       2012-07-02 13:25:03 UTC 
(rev 22436)
@@ -181,6 +181,10 @@
 
   /**
    * Binary value stored in the DNS record.
+   * FIXME: goofy API: sometimes 'data' is individually
+   * 'malloc'ed, sometimes it points into some existing
+   * data area (so sometimes this should be a 'void *',
+   * sometimes a 'const void *').  This is unclean.
    */
   const void *data;
 
@@ -387,7 +391,10 @@
  *
  * By specifying a 'zone' of NULL and setting 'GNUNET_NAMESTORE_RF_AUTHORITY'
  * in 'must_have_flags', we can iterate over all records for which we are
- * the authority.  In this case, the 'GNUNET_NAMESTORE_RF_RELATIVE_EXPIRATION'
+ * the authority (the 'authority' flag will NOT be set in the returned
+ * records anyway).  
+ *
+ * The 'GNUNET_NAMESTORE_RF_RELATIVE_EXPIRATION'
  * bit in 'must_have_flags' has a special meaning:
  *
  * 0) If the bit is clear, all relative expriation times are converted to