merged AI doc, some new pages

libs/main/core/piincludes.h

@@ -1,8 +1,8 @@
 /*! \file piincludes.h
  * \ingroup Core
  * \~\brief
- * \~english Minimal PIP includes
- * \~russian Минимально-необходимые инклюды PIP
+ * \~english Core includes and low-level helper functions
+ * \~russian Базовые включения и низкоуровневые вспомогательные функции
  */
 /*
     PIP - Platform Independent Primitives
@@ -50,27 +50,42 @@ class PIWaitEvent;
 
 struct lconv;
 
+//! \~\ingroup Core
+//! \~\brief
+//! \~english Pointer to current C locale numeric settings
+//! \~russian Указатель на текущие числовые настройки C locale
 extern PIP_EXPORT lconv * currentLocale;
 
-//! \ingroup Core
-//! \brief
-//! \~english Return readable error description in format "code <number> - <description>"
-//! \~russian Возвращает читаемое описание ошибки в формате "code <номер> - <описание>"
+//! \~\ingroup Core
+//! \~\brief
+//! \~english Returns readable description of the last system error in format
+//! "code <number> - <description>"
+//! \~russian Возвращает читаемое описание последней системной ошибки в формате
+//! "code <номер> - <описание>"
 PIP_EXPORT PIString errorString();
 
-//! \ingroup Core
-//! \brief
-//! \~english Reset last error
-//! \~russian Сброс последней ошибки
+//! \~\ingroup Core
+//! \~\brief
+//! \~english Clears the last system error
+//! \~russian Сбрасывает последнюю системную ошибку
 PIP_EXPORT void errorClear();
 
+//! \~\ingroup Core
+//! \~\brief
+//! \~english Seeds the global pseudo-random generator
+//! \~russian Инициализирует глобальный генератор псевдослучайных чисел
 PIP_EXPORT void randomize();
+
+//! \~\ingroup Core
+//! \~\brief
+//! \~english Returns next value from the global pseudo-random generator
+//! \~russian Возвращает следующее значение глобального генератора псевдослучайных чисел
 PIP_EXPORT int randomi();
 
-//! \ingroup Core
-//! \brief
-//! \~english Return readable version of PIP
-//! \~russian Возвращает читаемую версию PIP
+//! \~\ingroup Core
+//! \~\brief
+//! \~english Returns readable PIP version string
+//! \~russian Возвращает строку версии PIP
 PIP_EXPORT PIString PIPVersion();
 
 #endif // PIINCLUDES_H