lib: document config metadata
authorDavid Bremner <david@tethera.net>
Sat, 4 Jun 2016 22:17:41 +0000 (19:17 -0300)
committerDavid Bremner <david@tethera.net>
Tue, 7 Jun 2016 10:51:57 +0000 (07:51 -0300)
This probably should have been part of 3458e3c89c, but I missed it.

lib/database.cc

index 86bf26192079bcbcf9f5475556d0ad71be2fef0b..2b2d8219d29e5e963517b2a9c5219dec56be83dc 100644 (file)
@@ -185,6 +185,14 @@ typedef struct {
  *                     generated is 1 and the value will be
  *                     incremented for each thread ID.
  *
+ *     C*              metadata keys starting with C indicate
+ *                     configuration data. It can be managed with the
+ *                     n_database_*config* API.  There is a convention
+ *                     of hierarchical keys separated by '.' (e.g.
+ *                     query.notmuch stores the value for the named
+ *                     query 'notmuch'), but it is not enforced by the
+ *                     API.
+ *
  * Obsolete metadata
  * -----------------
  *