improve class comments

Core/Parametrization/IParameter.h

@@ -21,8 +21,10 @@
 #include <functional>
 #include <string>
 
-//! Pure virtual base class for parameter wrapper classes RealParameter, ObjectParameter.
-//! It's templated on the data type of the wrapped parameter.
+//! Pure virtual base class for parameter wrapper classes RealParameter, ComponentParameter.
+//! Holds a pointer to the wrapped parameter, a name, and a callback function to be called
+//! when the parameter is changed.
+//! This class is templated on the data type of the wrapped parameter.
 //! @class IParameter
 //! @ingroup tools_internal
 

Core/Parametrization/RealParameter.h

@@ -24,8 +24,9 @@
 
 class ParameterPool;
 
-//! Wrapper to real parameter for remote access to its value and callback abilities
-//! @class RealParameter
+//! Wraps a parameter of type double.
+//! In addition to name and on-change callback held by the parent class IParameter,
+//! this class holds Limits, Attributes (currently only fixed or not), and a Unit.
 //! @ingroup tools_internal
 
 class BA_CORE_API_ RealParameter : public IParameter<double> {