Hi, I've updated these related files also, now it fully covers entire source codes, of course, there needs to be modified/corrected, especially the followings,
o core/extensions.c
- * The <headlen> part is simply <len> - <paylen> so it is not stored.
+ * The \<headlen\> part is simply \<len\> - \<paylen\> so it is not stored.
o core/upload_stats.c
- * <url-escaped filename> <file size> <attempts> <completions>
+ * \<url-escaped filename\> \<file size\> \<attempts\> \<completions\>
backslash or "<" ">" might be replaced.
o lib/hashlist.c
/**
+ * @ingroup lib
* @file
*
+ * Needs short description here.
+ *
o lib/idtable.h
-/*
+/**
+ * @ingroup lib
+ * @file
+ *
+ * Needs short description here.
+ *
o lib/iprange.c
/**
+ * @ingroup lib
* @file
*
+ * Needs short description here.
+ *
those require brief description.
And what I'd like to hear is how to treat initial comment box, i.e.
there're some duplications between actual initial box
/*
* $Id: dmesh.c,v 1.17 2005/05/05 16:56:00 cbiere Exp $
*
* Copyright (c) 2002-2003, Raphael Manfredi
*
* Download mesh.
*
*---...
and following doxygen's initial comment box
/**
* @ingroup core
* @file
*
* Download mesh.
*
* @author Raphael Manfredi
* @date 2002-2003
*/
I know heavy doxygen-nized comment box would be hard to read for those
who prefer reading source code directly in ASCII to viewing generated
HTML through a browser, so could someone give me certain guideline ?
Probably this patch requires to be re-written, I think.
By the way, is there any possibility these generated HTML files are
hosted at http://gtk-gnutella.sourceforge.net/ somewhere ? covered
percentage is still not enough (in doxygen format wise) though.
--
Daichi
doxygen.patch.bz2
Description: BZip2 compressed data
