more ai generated doc with human review

libs/main/units/piunits.h

@@ -1,9 +1,15 @@
-/*! \file piunits.h
- * \ingroup Core
- * \~\brief
- * \~english Unit conversions
- * \~russian Преобразование единиц измерения
- */
+//! \addtogroup Units
+//! \{
+//! \file piunits.h
+//! \brief
+//! \~english Unit conversions main header
+//! \~russian Главный заголовочный файл преобразования единиц измерения
+//! \details
+//! \~english This is the main include file for unit conversion functionality. It includes all unit classes: Angle, Distance, Information,
+//! Mass, Pressure, Temperature, and Time.
+//! \~russian Это главный включаемый файл для функциональности преобразования единиц. Он включает все классы единиц: Angle, Distance,
+//! Information, Mass, Pressure, Temperature и Time.
+//! \}
 /*
     PIP - Platform Independent Primitives
     Unit conversions

libs/main/units/piunits_class_angle.h

@@ -1,9 +1,15 @@
-/*! \file piunits_class_angle.h
- * \ingroup Core
- * \~\brief
- * \~english Angle units
- * \~russian Единицы измерения угла
- */
+//! \addtogroup Units
+//! \{
+//! \file piunits_class_angle.h
+//! \brief
+//! \~english Angle units header
+//! \~russian Заголовочный файл единиц измерения угла
+//! \details
+//! \~english Defines the Angle unit class with support for Degree and Radian units.
+//! \~russian Определяет класс единиц Angle с поддержкой единиц Degree и Radian.
+//!
+//! \~\sa PIUnits::Class::Angle
+//! \}
 /*
     PIP - Platform Independent Primitives
     Angle units

libs/main/units/piunits_class_distance.h

@@ -1,9 +1,15 @@
-/*! \file piunits_class_distance.h
- * \ingroup Core
- * \~\brief
- * \~english Distance units
- * \~russian Единицы измерения расстояния
- */
+//! \addtogroup Units
+//! \{
+//! \file piunits_class_distance.h
+//! \brief
+//! \~english Distance units header
+//! \~russian Заголовочный файл единиц измерения расстояния
+//! \details
+//! \~english Defines the Distance unit class with support for Meter, Inch, Mil, Foot, Yard, Angstrom, and AstronomicalUnit.
+//! \~russian Определяет класс единиц Distance с поддержкой единиц Meter, Inch, Mil, Foot, Yard, Angstrom и AstronomicalUnit.
+//!
+//! \~\sa PIUnits::Class::Distance
+//! \}
 /*
     PIP - Platform Independent Primitives
     Distance units

libs/main/units/piunits_class_information.h

@@ -1,9 +1,15 @@
-/*! \file piunits_class_information.h
- * \ingroup Core
- * \~\brief
- * \~english Information units
- * \~russian Единицы измерения информации
- */
+//! \addtogroup Units
+//! \{
+//! \file piunits_class_information.h
+//! \brief
+//! \~english Information units header
+//! \~russian Заголовочный файл единиц измерения информации
+//! \details
+//! \~english Defines the Information unit class with support for Bit and Byte units.
+//! \~russian Определяет класс единиц Information с поддержкой единиц Bit и Byte.
+//!
+//! \~\sa PIUnits::Class::Information
+//! \}
 /*
     PIP - Platform Independent Primitives
     Information units

libs/main/units/piunits_class_mass.h

@@ -1,12 +1,18 @@
-/*! \file piunits_class_distance.h
- * \ingroup Core
- * \~\brief
- * \~english Mass units
- * \~russian Единицы измерения массы
- */
+//! \addtogroup Units
+//! \{
+//! \file piunits_class_mass.h
+//! \brief
+//! \~english Mass units header
+//! \~russian Заголовочный файл единиц измерения массы
+//! \details
+//! \~english Defines the Mass unit class with support for Gram, Pound, and Ounce units.
+//! \~russian Определяет класс единиц Mass с поддержкой единиц Gram, Pound и Ounce.
+//!
+//! \~\sa PIUnits::Class::Mass
+//! \}
 /*
     PIP - Platform Independent Primitives
-	Mass units
+    Mass units
     Ivan Pelipenko peri4ko@yandex.ru
 
     This program is free software: you can redistribute it and/or modify

libs/main/units/piunits_class_pressure.h

@@ -1,9 +1,15 @@
-/*! \file piunits_class_pressure.h
- * \ingroup Core
- * \~\brief
- * \~english Pressure units
- * \~russian Единицы измерения давления
- */
+//! \addtogroup Units
+//! \{
+//! \file piunits_class_pressure.h
+//! \brief
+//! \~english Pressure units header
+//! \~russian Заголовочный файл единиц измерения давления
+//! \details
+//! \~english Defines the Pressure unit class with support for Pascal, Atmosphere, Bar, and MillimetreOfMercury units.
+//! \~russian Определяет класс единиц Pressure с поддержкой единиц Pascal, Atmosphere, Bar и MillimetreOfMercury.
+//!
+//! \~\sa PIUnits::Class::Pressure
+//! \}
 /*
     PIP - Platform Independent Primitives
     Pressure units

libs/main/units/piunits_class_temperature.h

@@ -1,9 +1,19 @@
-/*! \file piunits_class_temperature.h
- * \ingroup Core
- * \~\brief
- * \~english Temperature units
- * \~russian Единицы измерения температуры
- */
+//! \addtogroup Units
+//! \{
+//! \file piunits_class_temperature.h
+//! \brief
+//! \~english Temperature units header
+//! \~russian Заголовочный файл единиц измерения температуры
+//! \details
+//! \~english Defines the Temperature unit class with support for Kelvin, Celsius, and Fahrenheit units.
+//! \~russian Определяет класс единиц Temperature с поддержкой единиц Kelvin, Celsius и Fahrenheit.
+//!
+//! \note
+//! \~english Temperature conversion requires offset calculations, not just multiplication.
+//! \~russian Преобразование температуры требует вычислений со смещением, а не только умножения.
+//!
+//! \~\sa PIUnits::Class::Temperature
+//! \}
 /*
     PIP - Platform Independent Primitives
     Temperature units

libs/main/units/piunits_class_time.h

@@ -1,9 +1,19 @@
-/*! \file piunits_class_time.h
- * \ingroup Core
- * \~\brief
- * \~english Time units
- * \~russian Единицы измерения времени
- */
+//! \addtogroup Units
+//! \{
+//! \file piunits_class_time.h
+//! \brief
+//! \~english Time units header
+//! \~russian Заголовочный файл единиц измерения времени
+//! \details
+//! \~english Defines the Time unit class with support for Second and Hertz units.
+//! \~russian Определяет класс единиц Time с поддержкой единиц Second и Hertz.
+//!
+//! \note
+//! \~english Hertz is the frequency unit, inverse of second.
+//! \~russian Герц - единица частоты, обратная секунде.
+//!
+//! \~\sa PIUnits::Class::Time
+//! \}
 /*
     PIP - Platform Independent Primitives
     Time units