merged AI doc, some new pages

libs/main/units/piunits_class_distance.h

@@ -1,9 +1,14 @@
-/*! \file piunits_class_distance.h
- * \ingroup Core
- * \~\brief
- * \~english Distance units
- * \~russian Единицы измерения расстояния
- */
+//! \~\file piunits_class_distance.h
+//! \~\ingroup Units
+//! \~\brief
+//! \~english Distance unit family descriptor
+//! \~russian Описатель семейства единиц расстояния
+//!
+//! \~\details
+//! \~english
+//! Declares %PIUnits::Class::Distance and its public type identifiers for distance conversions.
+//! \~russian
+//! Объявляет %PIUnits::Class::Distance и его публичные идентификаторы типов для преобразования расстояний.
 /*
     PIP - Platform Independent Primitives
     Distance units
@@ -28,18 +33,25 @@
 
 #include "piunits_base.h"
 
+//! \class PIUnits::Class::Distance
+//! \~\ingroup Units
+//! \~\brief
+//! \~english Descriptor of distance units and their public type identifiers.
+//! \~russian Описатель единиц расстояния и их публичных идентификаторов типов.
 DECLARE_UNIT_CLASS_BEGIN(Distance, 0x600)
+	//! \~english Supported distance unit type identifiers.
+	//! \~russian Поддерживаемые идентификаторы типов единиц расстояния.
 	enum {
-		Meter = typeStart,
-		Inch,
-		Mil,
-		Foot,
-		Yard,
+        Meter = typeStart /** \~english Meter \~russian Метр */,
+        Inch /** \~english Inch \~russian Дюйм */,
+        Mil /** \~english Mil or thou \~russian Мил или thou */,
+        Foot /** \~english Foot \~russian Фут */,
+        Yard /** \~english Yard \~russian Ярд */,
 
-		Angstrom,
-		AstronomicalUnit,
+        Angstrom /** \~english Angstrom \~russian Ангстрем */,
+        AstronomicalUnit /** \~english Astronomical unit \~russian Астрономическая единица */,
 
-		_LastType,
+        _LastType
 	};
 DECLARE_UNIT_CLASS_END(Distance)