chiark / gitweb /
Update word break algorithm for Unicode 5.1.0 (based on UAX #29).
[disorder] / lib / kvp.h
index 745304b75f58f704f4921391efb0cf271b432468..0a7e4780d0af3691c25ea3a10043406f78e26c0f 100644 (file)
--- a/lib/kvp.h
+++ b/lib/kvp.h
 struct dynstr;
 struct sink;
 
+/** @brief Linked list of key-value pairs */
 struct kvp {
-  struct kvp *next;                    /* next entry */
-  const char *name;                    /* name */
-  const char *value;                   /* value */
+  /** @brief Next entry */
+  struct kvp *next;
+
+  /** @brief Name
+   *
+   * Might not be unique.  Must not be null.
+   */
+  const char *name;
+
+  /** @brief Value
+   *
+   * Must not be null.
+   */
+  const char *value;
 };
 
 struct kvp *kvp_urldecode(const char *ptr, size_t n);