diff --git a/include/re_aes.h b/include/re_aes.h
index ec8567c..7c2ae3c 100644
--- a/include/re_aes.h
+++ b/include/re_aes.h
@@ -9,6 +9,7 @@
 #define AES_BLOCK_SIZE 16
 #endif
 
+/** AES mode */
 enum aes_mode {
 	AES_MODE_CTR  /**< AES Counter mode (CTR) */
 };
diff --git a/src/dns/client.c b/src/dns/client.c
index 3e5a1b2..9535e07 100644
--- a/src/dns/client.c
+++ b/src/dns/client.c
@@ -1,5 +1,5 @@
 /**
- * @file client.c  DNS Client
+ * @file dns/client.c  DNS Client
  *
  * Copyright (C) 2010 Creytiv.com
  */
diff --git a/src/hmac/hmac.c b/src/hmac/hmac.c
index 2c407b6..ce89aad 100644
--- a/src/hmac/hmac.c
+++ b/src/hmac/hmac.c
@@ -1,5 +1,5 @@
 /**
- * @file hmac.c  HMAC-SHA1
+ * @file hmac/hmac.c  HMAC-SHA1
  *
  * Copyright (C) 2010 Creytiv.com
  */
diff --git a/src/ice/icem.c b/src/ice/icem.c
index e2f4262..ead5c0d 100644
--- a/src/ice/icem.c
+++ b/src/ice/icem.c
@@ -422,6 +422,8 @@ struct list *icem_validl(const struct icem *icem)
  * Set the default local candidates, for ICE-lite mode only
  *
  * @param icem ICE Media object
+ *
+ * @return 0 if success, otherwise errorcode
  */
 int icem_lite_set_default_candidates(struct icem *icem)
 {