please doxygen.

git-svn-id: file:///svn/unbound/trunk@898 be551aaa-1e26-0410-a405-d3ace91eadb9

diff --git a/doc/Changelog b/doc/Changelog
index 373aa6613aba3be93764644208d9a7dc8e6d63a0..6d984289299e5bfaed613e533bf9f57d7db30186 100644 (file)
--- 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 f3ae4a3fb7d2e994af1d7bed5de86cf54646ab93..179daa4e27ffaf167651295b371b10d7e54ba167 100644 (file)
--- 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 3be539ad574ff7e8b5e47cb7662e0c9e5725287b..70a3603d0b2f98232dd5184851449375ca62b60f 100644 (file)
--- 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 cfa9196138b69d937cffc5d4428b37c235caba43..654b1c04f8fb63f08c3bed34444dcfaf233f5b8d 100644 (file)
--- 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 712e8c9066384e3b5bf345c4232b49f080484668..3d6cb5e95eeaafbdaf0a7db5521e36ab8b062b92 100644 (file)
--- 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 5587a26f1f1035ff7cfcf6aa4201cc0c93aef917..1ca747506c2a0a8e36739a5fb33d898e7ae1c0a3 100644 (file)
--- 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 8e78f54ca219262bcb66a958caf94d353844c90e..3d73ef9c43a9155e014dea5011d25b06c1f5e305 100644 (file)
--- 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 a31c6e190e8a68697d623e04d40ce1276f0985d7..f0188d2def4f30f4380d0082cdd98ad84d1594e1 100644 (file)
--- 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);