diff --git a/data.c b/data.c
index db0d3aa..fa079cc 100644
--- a/data.c
+++ b/data.c
@@ -482,7 +482,7 @@ int index_len(const char *fn)
 }
 
 
-d_char *index_list(const char *fn, int max)
+xs_list *index_list(const char *fn, int max)
 /* returns an index as a list */
 {
     d_char *list = NULL;
@@ -508,7 +508,7 @@ d_char *index_list(const char *fn, int max)
 }
 
 
-d_char *index_list_desc(const char *fn, int skip, int show)
+xs_list *index_list_desc(const char *fn, int skip, int show)
 /* returns an index as a list, in reverse order */
 {
     d_char *list = NULL;
@@ -768,7 +768,7 @@ int object_announces_len(const char *id)
 }
 
 
-d_char *object_children(const char *id)
+xs_list *object_children(const char *id)
 /* returns the list of an object's children */
 {
     xs *fn = _object_index_fn(id, "_c.idx");
@@ -776,14 +776,14 @@ d_char *object_children(const char *id)
 }
 
 
-d_char *object_likes(const char *id)
+xs_list *object_likes(const char *id)
 {
     xs *fn = _object_index_fn(id, "_l.idx");
     return index_list(fn, XS_ALL);
 }
 
 
-d_char *object_announces(const char *id)
+xs_list *object_announces(const char *id)
 {
     xs *fn = _object_index_fn(id, "_a.idx");
     return index_list(fn, XS_ALL);
diff --git a/html.c b/html.c
index e06a82f..7de26bc 100644
--- a/html.c
+++ b/html.c
@@ -891,7 +891,7 @@ xs_str *html_entry(snac *snac, xs_str *os, const xs_dict *msg, int local,
             }
         }
 
-        if (strcmp(type, "Question") == 0) {
+        if (strcmp(type, "Question") == 0) { /** question content **/
             xs_list *oo = xs_dict_get(msg, "oneOf");
             xs_list *ao = xs_dict_get(msg, "anyOf");
             xs_list *p;
diff --git a/snac.h b/snac.h
index d83eddb..66ef0d3 100644
--- a/snac.h
+++ b/snac.h
@@ -69,8 +69,8 @@ int index_add(const char *fn, const char *md5);
 int index_gc(const char *fn);
 int index_first(const char *fn, char *buf, int size);
 int index_len(const char *fn);
-d_char *index_list(const char *fn, int max);
-d_char *index_list_desc(const char *fn, int skip, int show);
+xs_list *index_list(const char *fn, int max);
+xs_list *index_list_desc(const char *fn, int skip, int show);
 
 int object_add(const char *id, d_char *obj);
 int object_add_ow(const char *id, d_char *obj);
@@ -88,9 +88,9 @@ int object_unadmire(const char *id, const char *actor, int like);
 int object_likes_len(const char *id);
 int object_announces_len(const char *id);
 
-d_char *object_children(const char *id);
-d_char *object_likes(const char *id);
-d_char *object_announces(const char *id);
+xs_list *object_children(const char *id);
+xs_list *object_likes(const char *id);
+xs_list *object_announces(const char *id);
 int object_parent(const char *id, char *buf, int size);
 
 int object_user_cache_add(snac *snac, const char *id, const char *cachedir);