more ai generated doc with human review

libs/main/core/picollection.h

@@ -87,27 +87,27 @@
 #else
 
 #  define ADD_TO_COLLECTION(group, object) \
-	  static PICollection::CollectionAdder _PIP_ADD_COUNTER(_collection_adder_)(#group, object, "", false);
+	static PICollection::CollectionAdder _PIP_ADD_COUNTER(_collection_adder_)(#group, object, "", false);
 
 #  define ADD_TO_COLLECTION_WITH_NAME(group, object, name) \
-	  static PICollection::CollectionAdder _PIP_ADD_COUNTER(_collection_adder_)(#group, object, #name, false);
+	static PICollection::CollectionAdder _PIP_ADD_COUNTER(_collection_adder_)(#group, object, #name, false);
 
 #  define ADD_NEW_TO_COLLECTION(group, class) \
-	  static PICollection::CollectionAdder _PIP_ADD_COUNTER(_collection_adder_)(#group, new class(), "", true);
+	static PICollection::CollectionAdder _PIP_ADD_COUNTER(_collection_adder_)(#group, new class(), "", true);
 
 #  define ADD_NEW_TO_COLLECTION_WITH_NAME(group, class, name) \
-	  static PICollection::CollectionAdder _PIP_ADD_COUNTER(_collection_adder_)(#group, new class(), #name, true);
+	static PICollection::CollectionAdder _PIP_ADD_COUNTER(_collection_adder_)(#group, new class(), #name, true);
 
 #endif
 
-//! \ingroup Core
-//! \~\brief
-//! \~english Helper to collect and retrieve classes to groups.
-//! \~russian Помощник для создания и получения классов в группы.
+/// \~english Helper to collect and retrieve classes to groups.
+/// \~russian Помощник для создания и получения классов в группы.
 class PIP_EXPORT PICollection {
 	friend class __PICollectionInitializer;
 
 public:
+	//! \~english Default constructor
+	//! \~russian Конструктор по умолчанию
 	PICollection() { ; }
 
 	//! \~english Returns all existing groups by their names
@@ -118,10 +118,14 @@ public:
 	//! \~russian Возвращает все элементы группы "group"
 	static PIVector<const PIObject *> groupElements(const PIString & group);
 
+	//! \~english Add element "element" to group "group"
+	//! \~russian Добавляет элемент "element" в группу "group"
 	static bool addToGroup(const PIString & group, const PIObject * element);
 
 	class PIP_EXPORT CollectionAdder {
 	public:
+		//! \~english Constructor that adds element to group
+		//! \~russian Конструктор, который добавляет элемент в группу
 		CollectionAdder(const PIString & group, const PIObject * element, const PIString & name = PIString(), bool own = false);
 	};
 

libs/main/core/piinit.h

@@ -1,10 +1,13 @@
-/*! \file piinit.h
- * \ingroup Core
- * \~\brief
- * \~english Library initialization
- * \~russian Инициализация библиотеки
- */
-/*
+//! \addtogroup Core
+//! \{
+//! \file piinit.h
+//! \brief
+//! \~english Library initialization
+//! \~russian Инициализация библиотеки
+//! \details
+//! \~english This file provides initialization and build information for the PIP library.
+//! \~russian Этот файл предоставляет инициализацию и информацию о сборке для библиотеки PIP.
+/*!
     PIP - Platform Independent Primitives
     Initialization
     Ivan Pelipenko peri4ko@yandex.ru
@@ -37,6 +40,8 @@ class PIFile;
 class PIStringList;
 
 
+//! \~english Internal initializer class for automatic library initialization
+//! \~russian Внутренний класс инициализации для автоматической инициализации библиотеки
 class PIP_EXPORT __PIInit_Initializer__ {
 public:
 	__PIInit_Initializer__();
@@ -48,6 +53,8 @@ public:
 static __PIInit_Initializer__ __piinit_initializer__;
 
 
+//! \~english Provides library initialization and build information
+//! \~russian Предоставляет инициализацию библиотеки и информацию о сборке
 class PIP_EXPORT PIInit {
 	friend class __PIInit_Initializer__;
 	friend class PIFile;
@@ -69,6 +76,8 @@ public:
 		boCloud /*! \~english PICloud transport support \~russian Поддержка облачного транспорта PICloud */ = 0x200,
 		boConsole /*! \~english Console graphics support \~russian Поддержка графики в консоли */           = 0x400,
 	};
+	//! \~english Returns singleton instance of PIInit
+	//! \~russian Возвращает синглтон экземпляр PIInit
 	static PIInit * instance() { return __PIInit_Initializer__::__instance__; }
 
 	//! \ingroup Core
@@ -89,4 +98,5 @@ private:
 
 
 #endif // MICRO_PIP
+//! \}
 #endif // PIINIT_H

libs/main/core/piobject.h

@@ -175,6 +175,8 @@ public:
 	bool isPropertyExists(const char * name) const { return properties_.contains(piHashData((const uchar *)name, strlen(name))); }
 
 	void setThreadSafe(bool yes) { thread_safe_ = yes; }
+	//! \~english Returns if object is thread safe
+	//! \~russian Возвращает является ли объект потокобезопасным
 	bool isThreadSafe() const { return thread_safe_; }
 
 	bool execute(const PIString & method, const PIVector<PIVariantSimple> & vl);
@@ -279,10 +281,20 @@ public:
 	//! \~russian Возвращает цепочку наследования объекта (вместе с классом самого объекта)
 	PIStringList scopeList() const;
 
+	//! \~english Returns list of all event-handler methods
+	//! \~russian Возвращает список всех методов-обработчиков событий
 	PIStringList methodsEH() const;
+	//! \~english Returns if method "name" is event-handler
+	//! \~russian Возвращает является ли метод "name" обработчиком событий
 	bool isMethodEHContains(const PIString & name) const;
+	//! \~english Returns arguments of event-handler method "name"
+	//! \~russian Возвращает аргументы метода-обработчика событий "name"
 	PIString methodEHArguments(const PIString & name) const;
+	//! \~english Returns full format of event-handler method "name"
+	//! \~russian Возвращает полный формат метода-обработчика событий "name"
 	PIString methodEHFullFormat(const PIString & name) const;
+	//! \~english Returns event-handler method name from address "addr"
+	//! \~russian Возвращает имя метода-обработчика событий по адресу "addr"
 	PIString methodEHFromAddr(const void * addr) const;
 
 	// / Direct connect
@@ -542,6 +554,8 @@ public:
 	//! \~english Returns if "o" is valid %PIObject (check signature)
 	//! \~russian Возвращает действительный ли "o" %PIObject (проверяет подпись)
 	static bool isPIObject(const PIObject * o);
+	//! \~english Returns if "o" is valid %PIObject (check signature)
+	//! \~russian Возвращает действительный ли "o" %PIObject (проверяет подпись)
 	static bool isPIObject(const void * o) { return isPIObject((PIObject *)o); }
 
 	//! \~english Returns if "o" is valid %PIObject subclass "T" (check signature and classname)
@@ -554,6 +568,8 @@ public:
 	static bool isTypeOf(const void * o) {
 		return isTypeOf<T>((PIObject *)o);
 	}
+	//! \~english Simplifies type name "a" to readable format
+	//! \~russian Упрощает имя типа "a" в читаемый формат
 	static PIString simplifyType(const char * a, bool readable = true);
 
 	struct PIP_EXPORT __MetaFunc {