Add DOCDOC comments for all undocumented functions. Add missing *s to other comments so that they will get recognized as doxygen.

svn:r17729

16 files changed, 92 insertions, 12 deletions

diff --git a/src/or/connection.c b/src/or/connection.c
index 23da915560..b30cbe2acd 100644
--- a/src/or/connection.c
+++ b/src/or/connection.c
@@ -153,6 +153,7 @@ conn_state_to_string(int type, int state)
   return buf;
 }
 
+/* DOCDOC dir_connection_new */
 dir_connection_t *
 dir_connection_new(int socket_family)
 {
@@ -160,6 +161,7 @@ dir_connection_new(int socket_family)
   connection_init(time(NULL), TO_CONN(dir_conn), CONN_TYPE_DIR, socket_family);
   return dir_conn;
 }
+/* DOCDOC or_connection_new */
 or_connection_t *
 or_connection_new(int socket_family)
 {
@@ -172,6 +174,7 @@ or_connection_new(int socket_family)
 
   return or_conn;
 }
+/* DOCDOC edge_connection_new */
 edge_connection_t *
 edge_connection_new(int type, int socket_family)
 {
@@ -182,6 +185,7 @@ edge_connection_new(int type, int socket_family)
     edge_conn->socks_request = tor_malloc_zero(sizeof(socks_request_t));
   return edge_conn;
 }
+/* DOCDOC control_connection_new */
 control_connection_t *
 control_connection_new(int socket_family)
 {
@@ -192,6 +196,7 @@ control_connection_new(int socket_family)
   return control_conn;
 }
 
+/* DOCDOC connection_new */
 connection_t *
 connection_new(int type, int socket_family)
 {
@@ -806,6 +811,7 @@ create_unix_sockaddr(const char *listenaddress, char **readable_address)
 };
 #endif /* HAVE_SYS_UN_H */
 
+/* DOCDOC warn_too_many_conns */
 static void
 warn_too_many_conns(void)
 {
diff --git a/src/or/control.c b/src/or/control.c
index 0ba2588e9b..fafa1c1e5a 100644
--- a/src/or/control.c
+++ b/src/or/control.c
@@ -89,6 +89,7 @@ static char last_sent_bootstrap_message[BOOTSTRAP_MSG_LEN];
 #define EXTENDED_FORMAT 4
 #define NONEXTENDED_FORMAT 8
 #define ALL_FORMATS (EXTENDED_FORMAT|NONEXTENDED_FORMAT)
+/* DOCDOC event_format_t */
 typedef int event_format_t;
 
 static void connection_printf_to_buf(control_connection_t *conn,
@@ -502,7 +503,7 @@ send_control_done(control_connection_t *conn)
   connection_write_str_to_buf("250 OK\r\n", conn);
 }
 
-/* Send an event to all v1 controllers that are listening for code
+/** Send an event to all v1 controllers that are listening for code
  * <b>event</b>.  The event's body is given by <b>msg</b>.
  *
  * If <b>which</b> & SHORT_NAMES, the event contains short-format names: send
@@ -604,7 +605,7 @@ send_control_event_impl(uint16_t event, event_format_t which, int extended,
   }
 }
 
-/* Send an event to all v1 controllers that are listening for code
+/** Send an event to all v1 controllers that are listening for code
  * <b>event</b>.  The event's body is created by the printf-style format in
  * <b>format</b>, and other arguments as provided.
  *
@@ -620,7 +621,7 @@ send_control_event(uint16_t event, event_format_t which,
   va_end(ap);
 }
 
-/* Send an event to all v1 controllers that are listening for code
+/** Send an event to all v1 controllers that are listening for code
  * <b>event</b>.  The event's body is created by the printf-style format in
  * <b>format</b>, and other arguments as provided.
  *
@@ -3872,7 +3873,7 @@ control_event_bootstrap(bootstrap_status_t status, int progress)
   }
 }
 
-/* Called when Tor has failed to make bootstrapping progress in a way
+/** Called when Tor has failed to make bootstrapping progress in a way
  * that indicates a problem. <b>warn</b> gives a hint as to why, and
  * <b>reason</b> provides an "or_conn_end_reason" tag.
  */
diff --git a/src/or/directory.c b/src/or/directory.c
index a5590fae3e..b5475fe6de 100644
--- a/src/or/directory.c
+++ b/src/or/directory.c
@@ -872,6 +872,8 @@ _compare_strs(const void **a, const void **b)
 #if (CONDITIONAL_CONSENSUS_FPR_LEN > DIGEST_LEN)
 #error "conditional consensus fingerprint length is larger than digest length"
 #endif
+
+/* DOCDOC directory_get_consensus_url */
 static char *
 directory_get_consensus_url(int supports_conditional_consensus)
 {
@@ -2193,6 +2195,7 @@ typedef struct request_t {
  * of request.  Maps from request type to pointer to request_t. */
 static strmap_t *request_map = NULL;
 
+/* DOCDOC note_client_request */
 static void
 note_client_request(int purpose, int compressed, size_t bytes)
 {
diff --git a/src/or/dirserv.c b/src/or/dirserv.c
index 8694da702f..914fcc2f49 100644
--- a/src/or/dirserv.c
+++ b/src/or/dirserv.c
@@ -1156,7 +1156,7 @@ directory_fetches_from_authorities(or_options_t *options)
   return 1;
 }
 
-/* Return 1 if we should fetch new networkstatuses, descriptors, etc
+/** Return 1 if we should fetch new networkstatuses, descriptors, etc
  * on the "mirror" schedule rather than the "client" schedule.
  */
 int
@@ -1165,7 +1165,7 @@ directory_fetches_dir_info_early(or_options_t *options)
   return directory_fetches_from_authorities(options);
 }
 
-/* Return 1 if we should fetch new networkstatuses, descriptors, etc
+/** Return 1 if we should fetch new networkstatuses, descriptors, etc
  * on a very passive schedule -- waiting long enough for ordinary clients
  * to probably have the info we want. These would include bridge users,
  * and maybe others in the future e.g. if a Tor client uses another Tor
@@ -1592,6 +1592,7 @@ dirserv_get_runningrouters(void)
                          "v1 network status list", V1_AUTHORITY);
 }
 
+/* DOCDOC */
 cached_dir_t *
 dirserv_get_consensus(void)
 {
diff --git a/src/or/dirvote.c b/src/or/dirvote.c
index a245b36e7a..da34ab1dcf 100644
--- a/src/or/dirvote.c
+++ b/src/or/dirvote.c
@@ -219,7 +219,8 @@ get_voter(const networkstatus_t *vote)
   return smartlist_get(vote->voters, 0);
 }
 
-typedef struct {
+/* DOCDOC dir_src_ent_t */
+typedef struct dir_src_ent_t {
   networkstatus_t *v;
   const char *digest;
   int is_legacy;
@@ -235,6 +236,7 @@ _compare_votes_by_authority_id(const void **_a, const void **_b)
                 get_voter(b)->identity_digest, DIGEST_LEN);
 }
 
+/* DOCDOC _compare_dir_src_ents_by_authority_id */
 static int
 _compare_dir_src_ents_by_authority_id(const void **_a, const void **_b)
 {
diff --git a/src/or/dns.c b/src/or/dns.c
index 191fd068c1..271e348afd 100644
--- a/src/or/dns.c
+++ b/src/or/dns.c
@@ -186,6 +186,7 @@ evdns_log_cb(int warn, const char *msg)
   log(severity, LD_EXIT, "eventdns: %s", msg);
 }
 
+/* DOCDOC randfn */
 static void
 randfn(char *b, size_t n)
 {
diff --git a/src/or/dnsserv.c b/src/or/dnsserv.c
index d9ec3f0fa0..ff8d76e3b3 100644
--- a/src/or/dnsserv.c
+++ b/src/or/dnsserv.c
@@ -14,7 +14,7 @@ const char dnsserv_c_id[] =
 #include "or.h"
 #include "eventdns.h"
 
-/* Helper function: called by evdns whenever the client sends a request to our
+/** Helper function: called by evdns whenever the client sends a request to our
  * DNSPort.  We need to eventually answer the request <b>req</b>.
  */
 static void
@@ -149,7 +149,7 @@ evdns_server_callback(struct evdns_server_request *req, void *_data)
   tor_free(q_name);
 }
 
-/* Helper function: called whenever the client sends a resolve request to our
+/** Helper function: called whenever the client sends a resolve request to our
  * controller.  We need to eventually answer the request <b>req</b>.
  * Returns 0 if the controller will be getting (or has gotten) an event in
  * response; -1 if we couldn't launch the request.
@@ -291,7 +291,7 @@ dnsserv_resolved(edge_connection_t *conn,
   conn->dns_server_request = NULL;
 }
 
-/* Set up the evdns server port for the UDP socket on <b>conn</b>, which
+/** Set up the evdns server port for the UDP socket on <b>conn</b>, which
  * must be an AP_DNS_LISTENER */
 void
 dnsserv_configure_listener(connection_t *conn)
diff --git a/src/or/geoip.c b/src/or/geoip.c
index 055b977f3b..a0ac6039f2 100644
--- a/src/or/geoip.c
+++ b/src/or/geoip.c
@@ -438,6 +438,7 @@ _c_hist_compare(const void **_a, const void **_b)
  * are willing to talk about it? */
 #define GEOIP_MIN_OBSERVATION_TIME (12*60*60)
 
+/* DOCDOC round_to_next_multiple_of */
 static INLINE unsigned
 round_to_next_multiple_of(unsigned number, unsigned divisor)
 {
@@ -588,6 +589,7 @@ geoip_get_request_history(time_t now, geoip_client_action_t action)
   return result;
 }
 
+/* DOCDOC dump_geoip_stats */
 void
 dump_geoip_stats(void)
 {
diff --git a/src/or/main.c b/src/or/main.c
index 28a33480d9..63f538300d 100644
--- a/src/or/main.c
+++ b/src/or/main.c
@@ -1902,12 +1902,14 @@ try_locking(or_options_t *options, int err_if_locked)
   }
 }
 
+/* DOCDOC have_lockfile */
 int
 have_lockfile(void)
 {
   return lockfile != NULL;
 }
 
+/* DOCDOC release_lockfile */
 void
 release_lockfile(void)
 {
diff --git a/src/or/networkstatus.c b/src/or/networkstatus.c
index 869d812a1b..c0bb0638ff 100644
--- a/src/or/networkstatus.c
+++ b/src/or/networkstatus.c
@@ -234,6 +234,7 @@ router_reload_consensus_networkstatus(void)
   return 0;
 }
 
+/** Free all storage held by the vote_routerstatus object <b>rs</b>. */
 static void
 vote_routerstatus_free(vote_routerstatus_t *rs)
 {
diff --git a/src/or/policies.c b/src/or/policies.c
index 610a34ed05..a9553774b4 100644
--- a/src/or/policies.c
+++ b/src/or/policies.c
@@ -981,7 +981,7 @@ policy_summary_item_split(policy_summary_item_t* old, uint16_t new_starts)
 #define AT(x) ((policy_summary_item_t*)smartlist_get(summary, x))
 
 #define REJECT_CUTOFF_COUNT (1<<25)
-/* Split an exit policy summary so that prt_min and prt_max
+/** Split an exit policy summary so that prt_min and prt_max
  * fall at exactly the start and end of an item respectively.
  */
 static int
diff --git a/src/or/relay.c b/src/or/relay.c
index 6060da0b81..3071f16a58 100644
--- a/src/or/relay.c
+++ b/src/or/relay.c
@@ -1470,6 +1470,7 @@ packed_cell_alloc(void)
   ++total_cells_allocated;
   return mp_pool_get(cell_pool);
 }
+/* DOCDOC dump_cell_pool_usage */
 void
 dump_cell_pool_usage(int severity)
 {
diff --git a/src/or/router.c b/src/or/router.c
index cc2043d6a2..7c4226f969 100644
--- a/src/or/router.c
+++ b/src/or/router.c
@@ -149,12 +149,14 @@ get_my_v3_authority_signing_key(void)
   return authority_signing_key;
 }
 
+/* DOCDOC get_my_v3_legacy_cert */
 authority_cert_t *
 get_my_v3_legacy_cert(void)
 {
   return legacy_key_certificate;
 }
 
+/* DOCDOC get_my_v3_legacy_signing_key */
 crypto_pk_env_t *
 get_my_v3_legacy_signing_key(void)
 {
@@ -283,6 +285,7 @@ init_key_from_file(const char *fname, int generate, int severity)
   return NULL;
 }
 
+/* DOCDOC load_authority_keyset */
 static int
 load_authority_keyset(int legacy, crypto_pk_env_t **key_out,
                        authority_cert_t **cert_out)
@@ -1200,7 +1203,7 @@ router_get_my_descriptor(void)
   return body;
 }
 
-/* Return the extrainfo document for this OR, or NULL if we have none.
+/** Return the extrainfo document for this OR, or NULL if we have none.
  * Rebuilt it (and the server descriptor) if necessary. */
 extrainfo_t *
 router_get_my_extrainfo(void)
diff --git a/src/or/routerlist.c b/src/or/routerlist.c
index 427356422f..020061925b 100644
--- a/src/or/routerlist.c
+++ b/src/or/routerlist.c
@@ -549,6 +549,7 @@ router_should_rebuild_store(desc_store_t *store)
     return store->journal_len > (1<<15);
 }
 
+/* DOCDOC desc_get_store */
 static INLINE desc_store_t *
 desc_get_store(routerlist_t *rl, signed_descriptor_t *sd)
 {
@@ -2465,6 +2466,7 @@ dump_routerlist_mem_usage(int severity)
 #endif
 }
 
+/* DOCDOC _routerlist_find_elt */
 static INLINE int
 _routerlist_find_elt(smartlist_t *sl, void *ri, int idx)
 {
@@ -4368,6 +4370,7 @@ get_dir_info_status_string(void)
   return dir_info_status;
 }
 
+/* DOCDOC count_usable_descriptors */
 static void
 count_usable_descriptors(int *num_present, int *num_usable,
                          const networkstatus_t *consensus,
diff --git a/src/or/routerparse.c b/src/or/routerparse.c
index 1d11571db2..aa8457ece7 100644
--- a/src/or/routerparse.c
+++ b/src/or/routerparse.c
@@ -2847,6 +2847,7 @@ token_free(directory_token_t *tok)
     goto done_tokenizing;                                          \
   STMT_END
 
+/* DOCDOC token_check_object */
 static INLINE directory_token_t *
 token_check_object(memarea_t *area, const char *kwd,
                    directory_token_t *tok, obj_syntax o_syn)
diff --git a/src/or/test.c b/src/or/test.c
index 54d7439f2c..e2d4dacca4 100644
--- a/src/or/test.c
+++ b/src/or/test.c
@@ -54,6 +54,7 @@ int have_failed = 0;
 
 static char temp_dir[256];
 
+/* DOCDOC setup_directory */
 static void
 setup_directory(void)
 {
@@ -78,6 +79,7 @@ setup_directory(void)
   is_setup = 1;
 }
 
+/* DOCDOC get_fname */
 static const char *
 get_fname(const char *name)
 {
@@ -87,6 +89,7 @@ get_fname(const char *name)
   return buf;
 }
 
+/* DOCDOC remove_directory */
 static void
 remove_directory(void)
 {
@@ -110,6 +113,7 @@ remove_directory(void)
 #undef CACHE_GENERATED_KEYS
 
 static crypto_pk_env_t *pregen_keys[5] = {NULL, NULL, NULL, NULL, NULL};
+/* DOCDOC pk_generate */
 static crypto_pk_env_t *
 pk_generate(int idx)
 {
@@ -129,6 +133,7 @@ pk_generate(int idx)
 #endif
 }
 
+/* DOCDOC free_pregenerated_keys */
 static void
 free_pregenerated_keys(void)
 {
@@ -141,6 +146,7 @@ free_pregenerated_keys(void)
   }
 }
 
+/* DOCDOC test_buffers */
 static void
 test_buffers(void)
 {
@@ -383,6 +389,7 @@ test_buffers(void)
     buf_free(buf2);
 }
 
+/* DOCDOC test_crypto_dh */
 static void
 test_crypto_dh(void)
 {
@@ -424,6 +431,7 @@ test_crypto_dh(void)
   crypto_dh_free(dh2);
 }
 
+/* DOCDOC test_crypto_rng */
 static void
 test_crypto_rng(void)
 {
@@ -461,6 +469,7 @@ test_crypto_rng(void)
   ;
 }
 
+/* DOCDOC test_crypto_aes */
 static void
 test_crypto_aes(void)
 {
@@ -590,6 +599,7 @@ test_crypto_aes(void)
   tor_free(data3);
 }
 
+/* DOCDOC test_crypto_sha */
 static void
 test_crypto_sha(void)
 {
@@ -658,6 +668,7 @@ test_crypto_sha(void)
     crypto_free_digest_env(d2);
 }
 
+/* DOCDOC test_crypto_pk */
 static void
 test_crypto_pk(void)
 {
@@ -767,6 +778,7 @@ test_crypto_pk(void)
   tor_free(encoded);
 }
 
+/* DOCDOC test_crypto */
 static void
 test_crypto(void)
 {
@@ -875,6 +887,7 @@ test_crypto(void)
   tor_free(data3);
 }
 
+/* DOCDOC test_crypto_s2k */
 static void
 test_crypto_s2k(void)
 {
@@ -907,6 +920,7 @@ test_crypto_s2k(void)
   tor_free(buf3);
 }
 
+/* DOCDOC _compare_strs */
 static int
 _compare_strs(const void **a, const void **b)
 {
@@ -914,6 +928,7 @@ _compare_strs(const void **a, const void **b)
   return strcmp(s1, s2);
 }
 
+/* DOCDOC _compare_without_first_ch */
 static int
 _compare_without_first_ch(const void *a, const void **b)
 {
@@ -921,6 +936,7 @@ _compare_without_first_ch(const void *a, const void **b)
   return strcasecmp(s1+1, s2);
 }
 
+/* DOCDOC test_util */
 static void
 test_util(void)
 {
@@ -1413,6 +1429,7 @@ _test_eq_ip6(struct in6_addr *a, struct in6_addr *b, const char *e1,
     test_eq(port2, pt2);                                   \
   STMT_END
 
+/* DOCDOC test_util_ip6_helpers */
 static void
 test_util_ip6_helpers(void)
 {
@@ -1738,6 +1755,7 @@ test_util_ip6_helpers(void)
   ;
 }
 
+/* DOCDOC test_util_smartlist_basic */
 static void
 test_util_smartlist_basic(void)
 {
@@ -1776,6 +1794,7 @@ test_util_smartlist_basic(void)
   smartlist_free(sl);
 }
 
+/* DOCDOC test_util_smartlist_strings */
 static void
 test_util_smartlist_strings(void)
 {
@@ -2005,6 +2024,7 @@ test_util_smartlist_strings(void)
   tor_free(cp_alloc);
 }
 
+/* DOCDOC test_util_smartlist_overlap */
 static void
 test_util_smartlist_overlap(void)
 {
@@ -2057,6 +2077,7 @@ test_util_smartlist_overlap(void)
   smartlist_free(sl);
 }
 
+/* DOCDOC test_util_smartlist_digests */
 static void
 test_util_smartlist_digests(void)
 {
@@ -2089,6 +2110,7 @@ test_util_smartlist_digests(void)
   smartlist_free(sl);
 }
 
+/* DOCDOC test_util_smartlist_join */
 static void
 test_util_smartlist_join(void)
 {
@@ -2140,6 +2162,7 @@ test_util_smartlist_join(void)
   tor_free(joined);
 }
 
+/* DOCDOC test_util_bitarray */
 static void
 test_util_bitarray(void)
 {
@@ -2181,6 +2204,7 @@ test_util_bitarray(void)
     bitarray_free(ba);
 }
 
+/* DOCDOC test_util_digestset */
 static void
 test_util_digestset(void)
 {
@@ -2229,6 +2253,7 @@ static strmap_t *_thread_test_strmap = NULL;
 static char *_thread1_name = NULL;
 static char *_thread2_name = NULL;
 
+/* DOCDOC _thread_test_func */
 static void _thread_test_func(void* _s) ATTR_NORETURN;
 
 static int t1_count = 0;
@@ -2274,6 +2299,7 @@ _thread_test_func(void* _s)
   spawn_exit();
 }
 
+/* DOCDOC test_util_threads */
 static void
 test_util_threads(void)
 {
@@ -2345,12 +2371,14 @@ test_util_threads(void)
     tor_mutex_free(_thread_test_start2);
 }
 
+/* DOCDOC _compare_strings_for_pqueue */
 static int
 _compare_strings_for_pqueue(const void *s1, const void *s2)
 {
   return strcmp((const char*)s1, (const char*)s2);
 }
 
+/* DOCDOC test_util_pqueue */
 static void
 test_util_pqueue(void)
 {
@@ -2408,6 +2436,7 @@ test_util_pqueue(void)
     smartlist_free(sl);
 }
 
+/* DOCDOC test_util_gzip */
 static void
 test_util_gzip(void)
 {
@@ -2514,6 +2543,7 @@ test_util_gzip(void)
   tor_free(buf1);
 }
 
+/* DOCDOC test_util_strmap */
 static void
 test_util_strmap(void)
 {
@@ -2604,6 +2634,7 @@ test_util_strmap(void)
   tor_free(visited);
 }
 
+/* DOCDOC test_util_mmap */
 static void
 test_util_mmap(void)
 {
@@ -2680,6 +2711,7 @@ test_util_mmap(void)
     tor_munmap_file(mapping);
 }
 
+/* DOCDOC test_util_control_formats */
 static void
 test_util_control_formats(void)
 {
@@ -2697,6 +2729,7 @@ test_util_control_formats(void)
   tor_free(out);
 }
 
+/* DOCDOC test_onion_handshake */
 static void
 test_onion_handshake(void)
 {
@@ -2745,6 +2778,7 @@ test_onion_handshake(void)
 
 extern smartlist_t *fingerprint_list;
 
+/* DOCDOC test_dir_format */
 static void
 test_dir_format(void)
 {
@@ -3065,6 +3099,7 @@ test_dir_format(void)
   tor_free(dir2); /* And more !*/
 }
 
+/* DOCDOC test_dirutil */
 static void
 test_dirutil(void)
 {
@@ -3100,6 +3135,7 @@ extern const char AUTHORITY_SIGNKEY_2[];
 extern const char AUTHORITY_CERT_3[];
 extern const char AUTHORITY_SIGNKEY_3[];
 
+/* DOCDOC test_same_voter */
 static void
 test_same_voter(networkstatus_voter_info_t *v1,
                 networkstatus_voter_info_t *v2)
@@ -3116,6 +3152,7 @@ test_same_voter(networkstatus_voter_info_t *v1,
   ;
 }
 
+/* DOCDOC test_util_order_functions */
 static void
 test_util_order_functions(void)
 {
@@ -3145,6 +3182,7 @@ test_util_order_functions(void)
   ;
 }
 
+/* DOCDOC generate_ri_from_rs */
 static routerinfo_t *
 generate_ri_from_rs(const vote_routerstatus_t *vrs)
 {
@@ -3167,6 +3205,7 @@ generate_ri_from_rs(const vote_routerstatus_t *vrs)
   return r;
 }
 
+/* DOCDOC test_v3_networkstatus */
 static void
 test_v3_networkstatus(void)
 {
@@ -3665,6 +3704,7 @@ test_v3_networkstatus(void)
     ns_detached_signatures_free(dsig2);
 }
 
+/* DOCDOC test_policy_summary_helper */
 static void
 test_policy_summary_helper(const char *policy_str,
                            const char *expected_summary)
@@ -3691,6 +3731,7 @@ test_policy_summary_helper(const char *policy_str,
     addr_policy_list_free(policy);
 }
 
+/* DOCDOC test_policies */
 static void
 test_policies(void)
 {
@@ -3849,6 +3890,7 @@ test_policies(void)
   }
 }
 
+/* DOCDOC test_rend_fns */
 static void
 test_rend_fns(void)
 {
@@ -3914,6 +3956,7 @@ test_rend_fns(void)
   tor_free(encoded);
 }
 
+/* DOCDOC bench_aes */
 static void
 bench_aes(void)
 {
@@ -3945,6 +3988,7 @@ bench_aes(void)
   crypto_free_cipher_env(c);
 }
 
+/* DOCDOC bench_dmap */
 static void
 bench_dmap(void)
 {
@@ -4008,6 +4052,7 @@ bench_dmap(void)
   smartlist_free(sl2);
 }
 
+/* DOCDOC test_util_mempool */
 static void
 test_util_mempool(void)
 {
@@ -4065,6 +4110,7 @@ test_util_mempool(void)
     mp_pool_destroy(pool);
 }
 
+/* DOCDOC test_util_memarea */
 static void
 test_util_memarea(void)
 {
@@ -4160,6 +4206,7 @@ test_util_memarea(void)
   tor_free(malloced_ptr);
 }
 
+/* DOCDOC test_util_datadir */
 static void
 test_util_datadir(void)
 {
@@ -4193,6 +4240,7 @@ test_util_datadir(void)
 }
 
 /* Test AES-CTR encryption and decryption with IV. */
+/* DOCDOC test_crypto_aes_iv */
 static void
 test_crypto_aes_iv(void)
 {
@@ -4329,6 +4377,7 @@ test_crypto_aes_iv(void)
 }
 
 /* Test base32 decoding. */
+/* DOCDOC test_crypto_base32_decode */
 static void
 test_crypto_base32_decode(void)
 {
@@ -4364,6 +4413,7 @@ test_crypto_base32_decode(void)
 }
 
 /* Test encoding and parsing of v2 rendezvous service descriptors. */
+/* DOCDOC test_rend_fns_v2 */
 static void
 test_rend_fns_v2(void)
 {
@@ -4464,6 +4514,7 @@ test_rend_fns_v2(void)
   tor_free(intro_points_encrypted);
 }
 
+/* DOCDOC test_geoip */
 static void
 test_geoip(void)
 {
@@ -4571,6 +4622,7 @@ static struct {
 };
 
 static void syntax(void) ATTR_NORETURN;
+/* DOCDOC syntax */
 static void
 syntax(void)
 {
@@ -4586,6 +4638,7 @@ syntax(void)
   exit(0);
 }
 
+/* DOCDOC main */
 int
 main(int c, char**v)
 {