Messed with documentation to try to make doxygen happy and more likely to see this file.

lladd/io/handle.h

@@ -7,6 +7,9 @@
 #define stasis_handle(x) stasis_handle_##x
 
 /**
+
+   @file
+
    Error handling:
    
    read, write, append, open, release_read_buffer and

lladd/io/rangeTracker.h

@@ -1,3 +1,5 @@
+
+/** @file */
 typedef struct range { 
   long start;
   long stop;
@@ -46,4 +48,3 @@ static inline long rangeTrackerRoundDown(long x, long quant) {
 static inline long rangeTrackerRoundUp(long x, long quant) { 
   return (((x-1) / quant) + 1) * quant;
 }
-

src/lladd/fifo.c

@@ -25,7 +25,7 @@ void lladdFifoPool_markDirty(int xid, lladdFifoPool_t * pool, lladdFifo_t * fifo
 /**
    Create a new pool of ringBuffer based fifos
 
-   @param consumerCount the number of consumers in the pool.
+   consumerCount is the number of consumers in the pool.
    @todo this function should be generalized to other consumer implementations.
 */
 lladdFifoPool_t * lladdFifoPool_ringBufferInit (int consumerCount, int bufferSize, 

src/lladd/io.c

@@ -1,6 +1,11 @@
 #include <stdio.h>
 #include "io.h"
 #include <stdlib.h>
+/** @file 
+
+    This file contains old-ish utility methods that wrap fseek, read, etc...
+
+*/
 long myFseek(FILE * f, long offset, int whence) {
   long ret;
   flockfile(f);

src/lladd/io/debug.c

@@ -2,6 +2,13 @@
 #include <stdio.h>
 #include <stdlib.h>
 
+/** @file 
+
+  This implements a io handle that wraps another handle, logging each
+  call (and its result) to stdout.
+
+*/
+
 typedef struct debug_impl {
   stasis_handle_t * h;
 } debug_impl;

src/lladd/io/file.c

@@ -13,6 +13,7 @@
 #include <sys/stat.h>
 #include <fcntl.h>
 
+/** @file */
 
 typedef struct file_impl { 
   pthread_mutex_t mut;

src/lladd/io/memory.c

@@ -3,7 +3,7 @@
 #include <string.h>
 #include <pthread.h>
 #include <errno.h>
-
+/** @file */
 
 typedef struct mem_impl {
   pthread_mutex_t mut;

src/lladd/io/non_blocking.c

@@ -6,7 +6,9 @@
 #include <assert.h>
 #include <stdio.h>
 #include <linkedlist.h>
-/*
+/**
+
+  @file
 
   Design:
 

src/lladd/page/header.c

@@ -32,7 +32,7 @@ void freePage(Page * freepage, long freepage_id, Page * headerpage) {
 }
 
 /**
-   @param freepage Must be the head of the freepage list (right now,
+   freepage Must be the head of the freepage list (right now,
    the free list is essentially treated like a stack.
 */
 void unfreePage(Page * freepage, Page * headerpage) {