merged AI doc, some new pages

libs/main/introspection/piintrospection_server.h

@@ -1,9 +1,8 @@
-/*! \file piintrospection_server.h
- * \ingroup Introspection
- * \~\brief
- * \~english Introspection server
- * \~russian Сервер интроспекции
- */
+//! \~\file piintrospection_server.h
+//! \~\ingroup Introspection
+//! \~\brief
+//! \~english Introspection server
+//! \~russian Сервер интроспекции
 /*
     PIP - Platform Independent Primitives
     Introspection module
@@ -28,12 +27,16 @@
 
 #ifdef DOXYGEN
 
-//! \ingroup Introspection
+//! \~\ingroup Introspection
+//! \relatesalso PIIntrospectionServer
+//! \~\brief
 //! \~english Start introspection server with name "name"
 //! \~russian Запускает сервер интроспекции с именем "name"
 #  define PIINTROSPECTION_START(name)
 
-//! \ingroup Introspection
+//! \~\ingroup Introspection
+//! \relatesalso PIIntrospectionServer
+//! \~\brief
 //! \~english Stop introspection server
 //! \~russian Останавливает сервер интроспекции
 #  define PIINTROSPECTION_STOP
@@ -51,13 +54,24 @@ class PISystemMonitor;
 #	define PIINTROSPECTION_START(name) PIINTROSPECTION_SERVER->start(#name);
 #	define PIINTROSPECTION_STOP        PIINTROSPECTION_SERVER->stop();
 
+//! \~\ingroup Introspection
+//! \~\brief
+//! \~english Peer-based server that replies to introspection requests for the current process.
+//! \~russian Сервер на основе peer, отвечающий на запросы интроспекции для текущего процесса.
 class PIP_EXPORT PIIntrospectionServer: public PIPeer {
 	PIOBJECT_SUBCLASS(PIIntrospectionServer, PIPeer);
 
 public:
+	//! \~english Returns singleton server instance.
+	//! \~russian Возвращает экземпляр сервера-синглтона.
 	static PIIntrospectionServer * instance();
 
+	//! \~english Starts the server and publishes it under name derived from `server_name`.
+	//! \~russian Запускает сервер и публикует его под именем, построенным от `server_name`.
 	void start(const PIString & server_name);
+
+	//! \~english Stops the server and releases its system monitor when needed.
+	//! \~russian Останавливает сервер и при необходимости освобождает его системный монитор.
 	void stop();
 
 private: