merged AI doc, some new pages

libs/main/piplatform.h

@@ -1,3 +1,17 @@
+/*! \file piplatform.h
+ * \ingroup Core
+ * \~\brief
+ * \~english Public platform and compiler detection macros
+ * \~russian Публичные макросы определения платформы и компилятора
+ *
+ * \~\details
+ * \~english
+ * This header defines portability macros that can be used in public PIP-aware
+ * code for platform, compiler and architecture checks.
+ * \~russian
+ * Этот заголовок определяет макросы переносимости, которые можно использовать
+ * в публичном PIP-коде для проверки платформы, компилятора и архитектуры.
+ */
 /*
     PIP - Platform Independent Primitives
     Platform and compiler macros
@@ -22,6 +36,94 @@
 
 #include <pip_export.h>
 
+#ifdef DOXYGEN
+
+//! \~\ingroup Core
+//! \~\brief
+//! \~english Defined for Windows targets.
+//! \~russian Определяется для целевых сборок Windows.
+#  define WINDOWS
+
+//! \~\ingroup Core
+//! \~\brief
+//! \~english Defined for Linux targets.
+//! \~russian Определяется для целевых сборок Linux.
+#  define LINUX
+
+//! \~\ingroup Core
+//! \~\brief
+//! \~english Defined for macOS targets.
+//! \~russian Определяется для целевых сборок macOS.
+#  define MAC_OS
+
+//! \~\ingroup Core
+//! \~\brief
+//! \~english Defined for Android targets.
+//! \~russian Определяется для целевых сборок Android.
+#  define ANDROID
+
+//! \~\ingroup Core
+//! \~\brief
+//! \~english Defined for QNX targets.
+//! \~russian Определяется для целевых сборок QNX.
+#  define QNX
+
+//! \~\ingroup Core
+//! \~\brief
+//! \~english Defined for FreeBSD targets.
+//! \~russian Определяется для целевых сборок FreeBSD.
+#  define FREE_BSD
+
+//! \~\ingroup Core
+//! \~\brief
+//! \~english Defined for reduced embedded PIP builds.
+//! \~russian Определяется для облегченных встраиваемых сборок PIP.
+#  define MICRO_PIP
+
+//! \~\ingroup Core
+//! \~\brief
+//! \~english Defined when the target architecture is 32-bit.
+//! \~russian Определяется, когда целевая архитектура 32-битная.
+#  define ARCH_BITS_32
+
+//! \~\ingroup Core
+//! \~\brief
+//! \~english Defined when the target architecture is 64-bit.
+//! \~russian Определяется, когда целевая архитектура 64-битная.
+#  define ARCH_BITS_64
+
+//! \~\ingroup Core
+//! \~\brief
+//! \~english Defined for GCC-compatible compilers.
+//! \~russian Определяется для GCC-совместимых компиляторов.
+#  define CC_GCC
+
+//! \~\ingroup Core
+//! \~\brief
+//! \~english Encoded GCC major and minor version for \a CC_GCC builds.
+//! \~russian Содержит закодированную основную и дополнительную версию GCC для сборок с \a CC_GCC.
+#  define CC_GCC_VERSION
+
+//! \~\ingroup Core
+//! \~\brief
+//! \~english Defined for Microsoft Visual C++.
+//! \~russian Определяется для Microsoft Visual C++.
+#  define CC_VC
+
+//! \~\ingroup Core
+//! \~\brief
+//! \~english Defined when no dedicated compiler macro above matched.
+//! \~russian Определяется, когда ни один специализированный макрос компилятора выше не подошел.
+#  define CC_OTHER
+
+//! \~\ingroup Core
+//! \~\brief
+//! \~english Defined when POSIX signal APIs are expected to be available.
+//! \~russian Определяется, когда ожидается доступность POSIX API сигналов.
+#  define POSIX_SIGNALS
+
+#endif
+
 #if defined(WIN64) || defined(_WIN64) || defined(__WIN64__)
 #  define WINDOWS
 #  define ARCH_BITS_64