diff --git a/lib/errorlogger.h b/lib/errorlogger.h
index 503524785..6dce504b7 100644
--- a/lib/errorlogger.h
+++ b/lib/errorlogger.h
@@ -30,7 +30,7 @@ class Tokenizer;
 /// @{
 
 /**
- * This is an interface, which the class responsible of error logging
+ * @brief This is an interface, which the class responsible of error logging
  * should implement.
  */
 class ErrorLogger
@@ -352,7 +352,7 @@ private:
     void _writemsg(const Tokenizer *tokenizer, const std::list<const Token *> &callstack, const char severity[], const std::string &msg, const std::string &id);
 };
 
-/** enum class for severity */
+/** @brief enum class for severity. Used when reporting errors. */
 class Severity
 {
 public:
diff --git a/lib/mathlib.h b/lib/mathlib.h
index b0ef49b55..39571e033 100644
--- a/lib/mathlib.h
+++ b/lib/mathlib.h
@@ -25,6 +25,7 @@
 /// @addtogroup Core
 /// @{
 
+/** @brief simple math functions that uses operands stored in std::string. useful when performing math on tokens. */
 
 class MathLib
 {