From 0bdfbccbdcb7f7f08e51d0a7e39f46aa5fe0fdd7 Mon Sep 17 00:00:00 2001 From: Wouter Wijngaards Date: Fri, 25 Jan 2008 10:41:17 +0000 Subject: [PATCH] please doxygen. git-svn-id: file:///svn/unbound/trunk@898 be551aaa-1e26-0410-a405-d3ace91eadb9 --- doc/Changelog | 1 + testcode/ldns-testpkts.c | 4 ++-- testcode/readhex.c | 2 +- util/data/dname.c | 2 +- util/net_help.c | 2 +- util/netevent.c | 2 +- validator/val_nsec3.c | 2 +- validator/val_nsec3.h | 4 ++-- 8 files changed, 10 insertions(+), 9 deletions(-) diff --git a/doc/Changelog b/doc/Changelog index 373aa6613..6d9842892 100644 --- a/doc/Changelog +++ b/doc/Changelog @@ -3,6 +3,7 @@ - allows localhost to be queried when as a library. - fixup race condition between cancel and answer (in case of really fast answers that beat the cancel). + - please doxygen, put doxygen comment in one place. 24 January 2008: Wouter - tested the cancel() function. diff --git a/testcode/ldns-testpkts.c b/testcode/ldns-testpkts.c index f3ae4a3fb..179daa4e2 100644 --- a/testcode/ldns-testpkts.c +++ b/testcode/ldns-testpkts.c @@ -504,7 +504,7 @@ read_entry(FILE* in, const char* name, int *lineno, uint32_t* default_ttl, return 0; } -/** reads the canned reply file and returns a list of structs */ +/* reads the canned reply file and returns a list of structs */ struct entry* read_datafile(const char* name) { @@ -645,7 +645,7 @@ match_all(ldns_pkt* q, ldns_pkt* p, bool mttl) return 1; } -/** finds entry in list, or returns NULL */ +/* finds entry in list, or returns NULL */ struct entry* find_match(struct entry* entries, ldns_pkt* query_pkt, enum transport_type transport) diff --git a/testcode/readhex.c b/testcode/readhex.c index 3be539ad5..70a3603d0 100644 --- a/testcode/readhex.c +++ b/testcode/readhex.c @@ -58,7 +58,7 @@ skip_whites(const char** p) } } -/** takes a hex string and puts into buffer */ +/* takes a hex string and puts into buffer */ void hex_to_buf(ldns_buffer* pkt, const char* hex) { const char* p = hex; diff --git a/util/data/dname.c b/util/data/dname.c index cfa919613..654b1c04f 100644 --- a/util/data/dname.c +++ b/util/data/dname.c @@ -45,7 +45,7 @@ #include "util/log.h" #include "util/storage/lookup3.h" -/** determine length of a dname in buffer, no compression pointers allowed */ +/* determine length of a dname in buffer, no compression pointers allowed */ size_t query_dname_len(ldns_buffer* query) { diff --git a/util/net_help.c b/util/net_help.c index 712e8c906..3d6cb5e95 100644 --- a/util/net_help.c +++ b/util/net_help.c @@ -46,7 +46,7 @@ /** max length of an IP address (the address portion) that we allow */ #define MAX_ADDR_STRLEN 128 /* characters */ -/** returns true is string addr is an ip6 specced address */ +/* returns true is string addr is an ip6 specced address */ int str_is_ip6(const char* str) { diff --git a/util/netevent.c b/util/netevent.c index 5587a26f1..1ca747506 100644 --- a/util/netevent.c +++ b/util/netevent.c @@ -155,7 +155,7 @@ void comm_base_exit(struct comm_base* b) } } -/** send a UDP reply */ +/* send a UDP reply */ int comm_point_send_udp_msg(struct comm_point *c, ldns_buffer* packet, struct sockaddr* addr, socklen_t addrlen) diff --git a/validator/val_nsec3.c b/validator/val_nsec3.c index 8e78f54ca..3d73ef9c4 100644 --- a/validator/val_nsec3.c +++ b/validator/val_nsec3.c @@ -445,7 +445,7 @@ nsec3_iteration_count_high(struct val_env* ve, struct nsec3_filter* filter, return 0; } -/** nsec3_cache_compare for rbtree */ +/* nsec3_cache_compare for rbtree */ int nsec3_hash_cmp(const void* c1, const void* c2) { diff --git a/validator/val_nsec3.h b/validator/val_nsec3.h index a31c6e190..f0188d2de 100644 --- a/validator/val_nsec3.h +++ b/validator/val_nsec3.h @@ -242,10 +242,10 @@ struct nsec3_cached_hash { }; /** - * Rbtree for hash cache comparison function + * Rbtree for hash cache comparison function. * @param c1: key 1. * @param c2: key 2. - * @return comparison code, -1, 0, 1, of the keys. + * @return: comparison code, -1, 0, 1, of the keys. */ int nsec3_hash_cmp(const void* c1, const void* c2); -- 2.47.2