From: Christian Grothoff <christian@grothoff.org>
Date: Mon, 2 Jul 2012 13:25:03 +0000 (+0000)
Subject: -update docu
X-Git-Tag: initial-import-from-subversion-38251~12696
X-Git-Url: https://git.librecmc.org/?a=commitdiff_plain;h=be31c5cb271233f82757b1830f07485f6293d3b4;p=oweals%2Fgnunet.git

-update docu
---

diff --git a/src/include/gnunet_namestore_service.h b/src/include/gnunet_namestore_service.h
index aa3ad8017..b00967c00 100644
--- a/src/include/gnunet_namestore_service.h
+++ b/src/include/gnunet_namestore_service.h
@@ -181,6 +181,10 @@ struct GNUNET_NAMESTORE_RecordData
 
   /**
    * 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 @@ GNUNET_NAMESTORE_zone_to_name (struct GNUNET_NAMESTORE_Handle *h,
  *
  * 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