documentation cleanup

8 files changed, 19 insertions, 13 deletions

diff --git a/src/fs/fs_download.c b/src/fs/fs_download.c
index 9ab4c5ce0..f36807e77 100644
--- a/src/fs/fs_download.c
+++ b/src/fs/fs_download.c
@@ -128,7 +128,7 @@ compute_dblock_offset (uint64_t offset,
  * Fill in all of the generic fields for 
  * a download event.
  *
- * @param pc structure to fill in
+ * @param pi structure to fill in
  * @param dc overall download context
  */
 static void
@@ -229,7 +229,8 @@ try_reconnect (struct GNUNET_FS_DownloadContext *dc);
  * the specified node.
  *
  * @param fsize overall file size
- * @param off offset of the node
+ * @param totaldepth depth of the entire tree
+ * @param offset offset of the node
  * @param depth depth of the node
  * @return number of bytes stored in this node
  */
@@ -269,9 +270,9 @@ calculate_block_size (uint64_t fsize,
 
 
 /**
- * Process a search result.
+ * Process a download result.
  *
- * @param sc our search context
+ * @param dc our download context
  * @param type type of the result
  * @param data the (encrypted) response
  * @param size size of data
diff --git a/src/fs/fs_search.c b/src/fs/fs_search.c
index 1a9fc699e..85d65f483 100644
--- a/src/fs/fs_search.c
+++ b/src/fs/fs_search.c
@@ -46,7 +46,7 @@
  * Fill in all of the generic fields for 
  * a search event.
  *
- * @param pc structure to fill in
+ * @param pi structure to fill in
  * @param sc overall search context
  */
 static void
diff --git a/src/fs/fs_unindex.c b/src/fs/fs_unindex.c
index 977344b98..51d46ea37 100644
--- a/src/fs/fs_unindex.c
+++ b/src/fs/fs_unindex.c
@@ -82,8 +82,9 @@ unindex_reader (void *cls,
  * Fill in all of the generic fields for 
  * an unindex event.
  *
- * @param pc structure to fill in
- * @param sc overall unindex context
+ * @param pi structure to fill in
+ * @param uc overall unindex context
+ * @param offset where we are in the file (for progress)
  */
 static void
 make_unindex_status (struct GNUNET_FS_ProgressInfo *pi,
diff --git a/src/fs/fs_uri.c b/src/fs/fs_uri.c
index 1c0686ed9..38dba8991 100644
--- a/src/fs/fs_uri.c
+++ b/src/fs/fs_uri.c
@@ -470,7 +470,7 @@ c2v (unsigned char a)
 /**
  * Convert string back to binary data.
  *
- * @param input '\0'-terminated string
+ * @param input '\\0'-terminated string
  * @param data where to write binary data
  * @param size how much data should be converted
  * @return number of characters processed from input,
@@ -808,7 +808,7 @@ GNUNET_FS_uri_loc_get_uri (const struct GNUNET_FS_Uri *uri)
 /**
  * Construct a location URI (this peer will be used for the location).
  *
- * @param baseURI content offered by the sender
+ * @param baseUri content offered by the sender
  * @param cfg configuration information (used to find our hostkey)
  * @param expiration_time how long will the content be offered?
  * @return the location URI, NULL on error
diff --git a/src/fs/gnunet-directory.c b/src/fs/gnunet-directory.c
index 0cbf700d1..8fc477614 100644
--- a/src/fs/gnunet-directory.c
+++ b/src/fs/gnunet-directory.c
@@ -29,6 +29,10 @@ static int ret;
 
 /**
  * Print a meta data entry.
+ *
+ * @param cls closure (unused)
+ * @param type type of the keyword
+ * @param data value of the keyword
  */
 static int
 item_printer (void *cls,
@@ -49,7 +53,7 @@ item_printer (void *cls,
  * @param cls closure (not used)
  * @param filename name of the file in the directory
  * @param uri URI of the file
- * @param metadata metadata for the file; metadata for
+ * @param meta metadata for the file; metadata for
  *        the directory if everything else is NULL/zero
  * @param length length of the available data for the file
  *           (of type size_t since data must certainly fit
diff --git a/src/fs/gnunet-download.c b/src/fs/gnunet-download.c
index 681608d6b..00565b1a3 100644
--- a/src/fs/gnunet-download.c
+++ b/src/fs/gnunet-download.c
@@ -113,7 +113,7 @@ progress_cb (void *cls,
  * @param sched the scheduler to use
  * @param args remaining command-line arguments
  * @param cfgfile name of the configuration file used (for saving, can be NULL!)
- * @param cfg configuration
+ * @param c configuration
  */
 static void
 run (void *cls,
diff --git a/src/fs/gnunet-publish.c b/src/fs/gnunet-publish.c
index a30b36c9e..bf6a46914 100644
--- a/src/fs/gnunet-publish.c
+++ b/src/fs/gnunet-publish.c
@@ -258,7 +258,7 @@ publish_inspector (void *cls,
  * @param sched the scheduler to use
  * @param args remaining command-line arguments
  * @param cfgfile name of the configuration file used (for saving, can be NULL!)
- * @param cfg configuration
+ * @param c configuration
  */
 static void
 run (void *cls,
diff --git a/src/fs/gnunet-search.c b/src/fs/gnunet-search.c
index b744d2e1a..ed864fa1c 100644
--- a/src/fs/gnunet-search.c
+++ b/src/fs/gnunet-search.c
@@ -134,7 +134,7 @@ progress_cb (void *cls,
  * @param sched the scheduler to use
  * @param args remaining command-line arguments
  * @param cfgfile name of the configuration file used (for saving, can be NULL!)
- * @param cfg configuration
+ * @param c configuration
  */
 static void
 run (void *cls,