diff --git a/src/cache.c b/src/cache.c
index f9af772..890e52b 100644
--- a/src/cache.c
+++ b/src/cache.c
@@ -694,6 +694,7 @@ static int Seg_exist(Cache *cf, off_t offset)
 }
 /**
  * \brief Set the existence of a segment
+ * \param[in] cf the cache in-memory data structure
  * \param[in] offset the starting position of the segment.
  * \param[in] i 1 for exist, 0 for doesn't exist
  * \note Call this after downloading a segment.
diff --git a/src/cache.h b/src/cache.h
index a99d6f3..5a38597 100644
--- a/src/cache.h
+++ b/src/cache.h
@@ -94,12 +94,12 @@ void Cache_delete(const char *fn);
  * \details If the segment does not exist on the local hard disk, download from
  * the Internet
  * \param[in] cf the cache in-memory data structure
- * \param[out] buf the output buffer
- * \param[in] size the requested segment size
+ * \param[out] output_buf the output buffer
+ * \param[in] len the requested segment size
  * \param[in] offset the start of the segment
  * \return the length of the segment the cache system managed to obtain.
  * \note Called by fs_read(), verified to be working
  */
-long Cache_read(Cache *cf, char *output_buf, off_t size, off_t offset);
+long Cache_read(Cache *cf, char *output_buf, off_t len, off_t offset);
 
 #endif
diff --git a/src/util.h b/src/util.h
index 85e6388..bce1f20 100644
--- a/src/util.h
+++ b/src/util.h
@@ -12,7 +12,7 @@
  * the result in a new string.
  * \param[in] a the first string
  * \param[in] b the second string
- * \param[n] c the maximum length of the output string
+ * \param[in] n the maximum length of the output string
  */
 char *strndupcat(const char *a, const char *b, int n);