comments
diff --git a/include/json/value.h b/include/json/value.h
index b590825..836b663 100644
--- a/include/json/value.h
+++ b/include/json/value.h
@@ -34,21 +34,29 @@
namespace Json {
/** Base class for all exceptions we throw.
+ *
+ * We use nothing but these internally. Of course, STL can throw others.
*/
class JSON_API Exception;
/** Exceptions which the user cannot easily avoid.
*
- * E.g. out-of-memory, stack-overflow, malicious input
+ * E.g. out-of-memory (when we use malloc), stack-overflow, malicious input
+ *
+ * \remark derived from Json::Exception
*/
class JSON_API RuntimeError;
-/** Exceptions throw by JSON_ASSERT/JSON_FAIL macros.
+/** Exceptions thrown by JSON_ASSERT/JSON_FAIL macros.
*
* These are precondition-violations (user bugs) and internal errors (our bugs).
+ *
+ * \remark derived from Json::Exception
*/
class JSON_API LogicError;
-JSON_API void throwRuntimeError(std::string const& msg);
-JSON_API void throwLogicError(std::string const& msg);
+/// used internally
+void throwRuntimeError(std::string const& msg);
+/// used internally
+void throwLogicError(std::string const& msg);
/** \brief Type of the value held by a Value object.
*/