please doxygen.

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

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.

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)

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;

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)
 {

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)
 {

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) 

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) 
 {

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);