Doc.

diff --git a/generator.c b/generator.c
index 8e4ede0..2e6305a 100644 (file)
--- a/generator.c
+++ b/generator.c
@@ -217,15 +217,15 @@ static struct sum_struct *generate_sums(struct map_struct *buf,OFF_T len,int n)
 
 
 
-/*
- * Acts on file number I from FLIST, whose name is fname.
+/**
+ * Acts on file number @p i from @p flist, whose name is @p fname.
  *
  * First fixes up permissions, then generates checksums for the file.
  *
- * (This comment was added later by mbp who was trying to work it out;
- * it might be wrong.)
- */ 
-void recv_generator(char *fname,struct file_list *flist,int i,int f_out)
+ * @note This comment was added later by mbp who was trying to work it
+ * out.  It might be wrong.
+ **/ 
+void recv_generator(char *fname, struct file_list *flist, int i, int f_out)
 {  
        int fd;
        STRUCT_STAT st;