merged AI doc, some new pages

libs/main/introspection/piintrospection_base.h

@@ -1,3 +1,9 @@
+/*! \file piintrospection_base.h
+ * \ingroup Introspection
+ * \~\brief
+ * \~english Base declarations for the introspection subsystem
+ * \~russian Базовые объявления подсистемы интроспекции
+ */
 /*
     PIP - Platform Independent Primitives
     Introspection module - base macros and types
@@ -60,6 +66,22 @@ class PIPeer;
 class PIIntrospection;
 class PIIntrospectionServer;
 
+#ifdef DOXYGEN
+
+//! \~\ingroup Introspection
+//! \~\brief
+//! \~english Declares singleton accessor `instance()` for an introspection interface class.
+//! \~russian Объявляет метод-синглтон `instance()` для класса интерфейса интроспекции.
+#  define __PIINTROSPECTION_SINGLETON_H__(T)
+
+//! \~\ingroup Introspection
+//! \~\brief
+//! \~english Defines singleton accessor `instance()` for an introspection interface class.
+//! \~russian Определяет метод-синглтон `instance()` для класса интерфейса интроспекции.
+#  define __PIINTROSPECTION_SINGLETON_CPP__(T)
+
+#else
+
 #if defined(PIP_INTROSPECTION) && !defined(PIP_FORCE_NO_PIINTROSPECTION)
 #  define __PIINTROSPECTION_SINGLETON_H__(T) static PIIntrospection##T##Interface * instance();
 
@@ -69,4 +91,6 @@ class PIIntrospectionServer;
 		  return &ret;                                                            \
 	  }
 #endif // PIP_INTROSPECTION
+
+#endif // DOXYGEN
 #endif // PIINTROSPECTION_BASE_H