diff --git a/include/coap2/async.h b/include/coap2/async.h
index accd1876..094f365d 100644
--- a/include/coap2/async.h
+++ b/include/coap2/async.h
@@ -148,7 +148,7 @@ coap_touch_async(coap_async_state_t *s) { coap_ticks(&s->created); }
  *
  * Internal function.
  *
- * @param state The context to remove all async entries from.
+ * @param context The context to remove all async entries from.
  */
 void
 coap_delete_all_async(coap_context_t *context);
diff --git a/include/coap2/coap_prng.h b/include/coap2/coap_prng.h
index fdce7d25..f8dd18e7 100644
--- a/include/coap2/coap_prng.h
+++ b/include/coap2/coap_prng.h
@@ -8,7 +8,7 @@
  */
 
 /**
- * @file prng.h
+ * @file coap_prng.h
  * @brief Pseudo Random Numbers
  */
 
@@ -116,12 +116,12 @@ void coap_prng_init(unsigned long seed);
  * Fills @p buf with @p len random bytes using the default pseudo
  * random number generator. The default PRNG can be changed with
  * coap_set_prng(). This function returns 1 when @p len random bytes
- * have been written to @buf, zero otherwise.
+ * have been written to @p buf, zero otherwise.
  *
  * @param buf  The buffer to fill with random bytes.
  * @param len  The number of random bytes to write into @p buf.
  *
- * @param 1 on success, 0 otherwise.
+ * @return 1 on success, 0 otherwise.
  */
 int coap_prng(void *buf, size_t len);