fixup comments for doxygen 1.5

git-svn-id: file:///svn/unbound/trunk@383 be551aaa-1e26-0410-a405-d3ace91eadb9
This commit is contained in:
Wouter Wijngaards
2007-06-12 14:51:49 +00:00
parent 7a6abc6a11
commit 37a8e7e370
28 changed files with 79 additions and 60 deletions
+8 -8
View File
@@ -194,7 +194,7 @@ prot_check(struct checked_lock* lock,
}
}
/** Copy protected memory region. */
/** Copy protected memory region */
static void
prot_store(struct checked_lock* lock)
{
@@ -205,7 +205,7 @@ prot_store(struct checked_lock* lock)
}
}
/** write lock trace info to file, while you hold those locks. */
/** write lock trace info to file, while you hold those locks */
static void
ordercheck_locklock(struct thr_check* thr, struct checked_lock* lock)
{
@@ -225,7 +225,7 @@ ordercheck_locklock(struct thr_check* thr, struct checked_lock* lock)
log_err("fwrite: %s", strerror(errno));
}
/** write ordercheck lock creation details to file. */
/** write ordercheck lock creation details to file */
static void
ordercheck_lockcreate(struct thr_check* thr, struct checked_lock* lock)
{
@@ -365,7 +365,7 @@ checklock_destroy(enum check_lock_type type, struct checked_lock** lock,
free(e);
}
/** finish acquiring lock, shared between _(rd|wr||)lock() routines. */
/** finish acquiring lock, shared between _(rd|wr||)lock() routines */
static void
finish_acquire_lock(struct thr_check* thr, struct checked_lock* lock,
const char* func, const char* file, int line)
@@ -611,7 +611,7 @@ checklock_unlock(enum check_lock_type type, struct checked_lock* lock,
}
}
/** open order info debug file, thr->num must be valid. */
/** open order info debug file, thr->num must be valid */
static void
open_lockorder(struct thr_check* thr)
{
@@ -631,7 +631,7 @@ open_lockorder(struct thr_check* thr)
log_err("fwrite: %s", strerror(errno));
}
/** checklock thread main, Inits thread structure. */
/** checklock thread main, Inits thread structure */
static void* checklock_main(void* arg)
{
struct thr_check* thr = (struct thr_check*)arg;
@@ -791,7 +791,7 @@ total_debug_info()
}
}
/** signal handler for join timeout, Exits. */
/** signal handler for join timeout, Exits */
static RETSIGTYPE joinalarm(int ATTR_UNUSED(sig))
{
log_err("join thread timeout. hangup or deadlock. Info follows.");
@@ -799,7 +799,7 @@ static RETSIGTYPE joinalarm(int ATTR_UNUSED(sig))
fatal_exit("join thread timeout. hangup or deadlock.");
}
/** wait for thread with a timeout. */
/** wait for thread with a timeout */
void
checklock_thrjoin(pthread_t thread)
{
+1 -1
View File
@@ -73,7 +73,7 @@ fake_event_cleanup()
saved_scenario = NULL;
}
/** helper function that logs a ldns_pkt packet to logfile. */
/** helper function that logs a ldns_pkt packet to logfile */
static void
log_pkt(const char* desc, ldns_pkt* pkt)
{
+1 -1
View File
@@ -31,7 +31,7 @@ struct sockaddr_storage;
/** string to show in warnings and errors */
static const char* prog_name = "ldns-testpkts";
/** logging routine, provided by caller. */
/** logging routine, provided by caller */
void verbose(int lvl, const char* msg, ...);
/** print error and exit */
+1 -1
View File
@@ -309,7 +309,7 @@ static void found_cycle(struct lock_ref* visit, int level)
}
}
/** Detect cycle by comparing visited now with all (unvisited) bigger nodes. */
/** Detect cycle by comparing visited now with all (unvisited) bigger nodes */
static int detect_cycle(struct lock_ref* visit, struct lock_ref* from)
{
struct lock_ref* p = from;
+2 -2
View File
@@ -67,7 +67,7 @@ void read_input(ldns_buffer* pkt, FILE* in)
hex_to_buf(pkt, buf);
}
/** analyze domain name in packet, possibly compressed. */
/** analyze domain name in packet, possibly compressed */
void analyze_dname(ldns_buffer* pkt)
{
size_t oldpos = ldns_buffer_position(pkt);
@@ -117,7 +117,7 @@ void analyze_rdata(ldns_buffer*pkt, const ldns_rr_descriptor* desc,
ldns_buffer_skip(pkt, (ssize_t)rdlen);
}
/** analyze rr in packet. */
/** analyze rr in packet */
void analyze_rr(ldns_buffer* pkt, int q)
{
uint16_t type, dclass, len;
+1 -1
View File
@@ -210,7 +210,7 @@ replay_moment_read(char* remain, FILE* in, const char* name, int* lineno,
return mom;
}
/** makes scenario with title on rest of line. */
/** makes scenario with title on rest of line */
static struct replay_scenario*
make_scenario(char* line)
{
+1 -1
View File
@@ -105,7 +105,7 @@ add_opts(char* optarg, int* pass_argc, char* pass_argv[])
}
}
/** pretty print commandline for unbound in this test. */
/** pretty print commandline for unbound in this test */
static void
echo_cmdline(int argc, char* argv[])
{
+3 -3
View File
@@ -67,9 +67,9 @@ static void test_delkey(void*, void*, int);
static void test_deldata(void*, void*);
/* --- end test representation --- */
/** hash func, very bad to improve collisions. */
/** hash func, very bad to improve collisions */
static hashvalue_t myhash(int id) {return (hashvalue_t)id & 0x0f;}
/** allocate new key, fill in hash. */
/** allocate new key, fill in hash */
static struct testkey* newkey(int id) {
struct testkey* k = (struct testkey*)calloc(1, sizeof(struct testkey));
if(!k) fatal_exit("out of memory");
@@ -469,7 +469,7 @@ test_thr_main(void* arg)
return NULL;
}
/** test hash table access by multiple threads. */
/** test hash table access by multiple threads */
static void
test_threaded_table(struct lruhash* table)
{
+4 -4
View File
@@ -224,7 +224,7 @@ test_buffers(ldns_buffer* pkt, ldns_buffer* out)
return 0;
}
/** check if unbound formerr equals ldns formerr. */
/** check if unbound formerr equals ldns formerr */
static void
checkformerr(ldns_buffer* pkt)
{
@@ -303,7 +303,7 @@ testpkt(ldns_buffer* pkt, struct alloc_cache* alloc, ldns_buffer* out,
region_destroy(region);
}
/** simple test of parsing. */
/** simple test of parsing */
static void
simpletest(ldns_buffer* pkt, struct alloc_cache* alloc, ldns_buffer* out)
{
@@ -354,7 +354,7 @@ simpletest(ldns_buffer* pkt, struct alloc_cache* alloc, ldns_buffer* out)
" 64 b9 00 04 c0 3a 80 1e ");
}
/** simple test of parsing, pcat file. */
/** simple test of parsing, pcat file */
static void
testfromfile(ldns_buffer* pkt, struct alloc_cache* alloc, ldns_buffer* out,
const char* fname)
@@ -381,7 +381,7 @@ testfromfile(ldns_buffer* pkt, struct alloc_cache* alloc, ldns_buffer* out,
fclose(in);
}
/** simple test of parsing, drill file. */
/** simple test of parsing, drill file */
static void
testfromdrillfile(ldns_buffer* pkt, struct alloc_cache* alloc,
ldns_buffer* out, const char* fname)
+3 -3
View File
@@ -67,14 +67,14 @@ static void test_delkey(void*, void*, int);
static void test_deldata(void*, void*);
/* --- end test representation --- */
/** hash func, very bad to improve collisions, both high and low bits. */
/** hash func, very bad to improve collisions, both high and low bits */
static hashvalue_t myhash(int id) {
hashvalue_t h = (hashvalue_t)id & 0x0f;
h |= (h << 28);
return h;
}
/** allocate new key, fill in hash. */
/** allocate new key, fill in hash */
static struct slabtestkey* newkey(int id) {
struct slabtestkey* k = (struct slabtestkey*)calloc(1, sizeof(struct slabtestkey));
if(!k) fatal_exit("out of memory");
@@ -351,7 +351,7 @@ test_thr_main(void* arg)
return NULL;
}
/** test hash table access by multiple threads. */
/** test hash table access by multiple threads */
static void
test_threaded_table(struct slabhash* table)
{