more ai generated doc with human review

libs/main/application/picli.h

@@ -64,13 +64,25 @@ public:
 	//! \~english Returns unparsed command-line argument by index "index". Index 0 is program execute command.
 	//! \~russian Возвращает исходный аргумент командной строки по индексу "index". Индекс 0 это команда вызова программы.
 	PIString rawArgument(int index);
+
+	//! \~english Returns mandatory command-line argument by index "index".
+	//! \~russian Возвращает обязательный аргумент командной строки по индексу "index".
 	PIString mandatoryArgument(int index);
+
+	//! \~english Returns optional command-line argument by index "index".
+	//! \~russian Возвращает опциональный аргумент командной строки по индексу "index".
 	PIString optionalArgument(int index);
 
 	//! \~english Returns unparsed command-line arguments.
 	//! \~russian Возвращает исходные аргументы командной строки.
 	const PIStringList & rawArguments();
+
+	//! \~english Returns mandatory command-line arguments.
+	//! \~russian Возвращает обязательные аргументы командной строки.
 	const PIStringList & mandatoryArguments();
+
+	//! \~english Returns optional command-line arguments.
+	//! \~russian Возвращает опциональные аргументы командной строки.
 	const PIStringList & optionalArguments();
 
 	//! \~english Returns program execute command without arguments.
@@ -93,18 +105,52 @@ public:
 	//! \~russian Возвращает полный ключ аргумента "name" или пустую строку, если аргумента нет.
 	PIString argumentFullKey(const PIString & name);
 
+	//! \~english Returns short key prefix.
+	//! \~russian Возвращает префикс короткого ключа.
 	const PIString & shortKeyPrefix() const { return _prefix_short; }
+
+	//! \~english Returns full key prefix.
+	//! \~russian Возвращает префикс полного ключа.
 	const PIString & fullKeyPrefix() const { return _prefix_full; }
+
+	//! \~english Returns mandatory arguments count.
+	//! \~russian Возвращает количество обязательных аргументов.
 	int mandatoryArgumentsCount() const { return _count_mand; }
+
+	//! \~english Returns optional arguments count.
+	//! \~russian Возвращает количество опциональных аргументов.
 	int optionalArgumentsCount() const { return _count_opt; }
+
+	//! \~english Sets short key prefix.
+	//! \~russian Устанавливает префикс короткого ключа.
 	void setShortKeyPrefix(const PIString & prefix);
+
+	//! \~english Sets full key prefix.
+	//! \~russian Устанавливает префикс полного ключа.
 	void setFullKeyPrefix(const PIString & prefix);
+
+	//! \~english Sets mandatory arguments count.
+	//! \~russian Устанавливает количество обязательных аргументов.
 	void setMandatoryArgumentsCount(const int count);
+
+	//! \~english Sets optional arguments count.
+	//! \~russian Устанавливает количество опциональных аргументов.
 	void setOptionalArgumentsCount(const int count);
 
+	//! \~english Returns debug mode state.
+	//! \~russian Возвращает состояние режима отладки.
 	bool debug() const { return debug_; }
+
+	//! \~english Sets debug mode state.
+	//! \~russian Устанавливает состояние режима отладки.
 	void setDebug(bool debug) { debug_ = debug; }
+
+	//! \~english Returns class name.
+	//! \~russian Возвращает имя класса.
 	PIConstChars className() const { return "PICLI"; }
+
+	//! \~english Returns object name.
+	//! \~russian Возвращает имя объекта.
 	PIString name() const { return PIStringAscii("CLI"); }
 
 private:

libs/main/application/pilog.h

@@ -6,7 +6,7 @@
  */
 /*
     PIP - Platform Independent Primitives
-	High-level log
+    High-level log
     Ivan Pelipenko peri4ko@yandex.ru
 
     This program is free software: you can redistribute it and/or modify
@@ -38,7 +38,12 @@ class PIP_EXPORT PILog: public PIThread {
 	PIOBJECT_SUBCLASS(PILog, PIThread)
 
 public:
+	//! \~english Constructs empty %PILog.
+	//! \~russian Создает пустой %PILog.
 	PILog();
+
+	//! \~english Destructor. Calls stop().
+	//! \~russian Деструктор. Вызывает stop().
 	~PILog();
 
 	//! \~english Message category

libs/main/application/pisingleapplication.h

@@ -42,6 +42,8 @@ public:
 	//! \~russian Создает %PISingleApplication с именем "app_name"
 	PISingleApplication(const PIString & app_name = PIString());
 
+	//! \~english Destructor.
+	//! \~russian Деструктор.
 	~PISingleApplication();
 
 

libs/main/application/pisystemmonitor.h

@@ -227,23 +227,25 @@ public:
 	//! \~russian Возвращает статистику потоков наблюдаемого процесса
 	PIVector<ThreadStats> threadsStatistic() const;
 
+	//! \~english Sets process statistics.
+	//! \~russian Устанавливает статистику процесса.
 	void setStatistic(const ProcessStats & s);
 
 
-	//! \~english
-	//! \~russian
+	//! \~english Returns total RAM in bytes.
+	//! \~russian Возвращает общий объем ОЗУ в байтах.
 	static ullong totalRAM();
 
-	//! \~english
-	//! \~russian
+	//! \~english Returns free RAM in bytes.
+	//! \~russian Возвращает свободный объем ОЗУ в байтах.
 	static ullong freeRAM();
 
-	//! \~english
-	//! \~russian
+	//! \~english Returns used RAM in bytes.
+	//! \~russian Возвращает используемый объем ОЗУ в байтах.
 	static ullong usedRAM();
 
-	//! \~english
-	//! \~russian
+	//! \~english Event raised when new measurements are available.
+	//! \~russian Событие вызывается когда доступны новые измерения.
 	EVENT(measured);
 
 private:

libs/main/application/pitranslator.h

@@ -6,7 +6,7 @@
  */
 /*
     PIP - Platform Independent Primitives
-	Translation support
+    Translation support
     Ivan Pelipenko peri4ko@yandex.ru
 
     This program is free software: you can redistribute it and/or modify
@@ -38,15 +38,40 @@
 //! \~russian Поддержка перевода
 class PIP_EXPORT PITranslator {
 public:
+	//! \~english Translates string "in" with optional context.
+	//! \~russian Переводит строку "in" с опциональным контекстом.
 	static PIString tr(const PIString & in, const PIString & context = {});
+
+	//! \~english Translates string "in" with optional context.
+	//! \~russian Переводит строку "in" с опциональным контекстом.
 	static PIString tr(const char * in, const PIString & context = {}) { return tr(PIString::fromUTF8(in), context); }
+
+	//! \~english Returns original string without translation.
+	//! \~russian Возвращает оригинальную строку без перевода.
 	static PIString trNoOp(const PIString & in, const PIString & context = {}) { return in; }
+
+	//! \~english Returns original string without translation.
+	//! \~russian Возвращает оригинальную строку без перевода.
 	static PIString trNoOp(const char * in, const PIString & context = {}) { return trNoOp(PIString::fromUTF8(in), context); }
 
+	//! \~english Clears all loaded translations.
+	//! \~russian Очищает все загруженные переводы.
 	static void clear();
+
+	//! \~english Loads translation for language "short_lang" from directory "dir".
+	//! \~russian Загружает перевод для языка "short_lang" из директории "dir".
 	static void loadLang(const PIString & short_lang, PIString dir = {});
+
+	//! \~english Loads translation from config "content".
+	//! \~russian Загружает перевод из конфигурации "content".
 	static void loadConfig(const PIString & content);
+
+	//! \~english Loads translation from binary content.
+	//! \~russian Загружает перевод из бинарного содержимого.
 	static bool load(const PIByteArray & content);
+
+	//! \~english Loads translation from file.
+	//! \~russian Загружает перевод из файла.
 	static bool loadFile(const PIString & path);
 
 private:
@@ -59,10 +84,20 @@ private:
 };
 
 
+//! \~english Context-aware string wrapper for translation.
+//! \~russian Контекстно-зависимая обертка строки для перевода.
 class PIStringContextTr {
 public:
+	//! \~english Constructs wrapper from string.
+	//! \~russian Создает обертку из строки.
 	PIStringContextTr(PIString && s): _s(s) {}
+
+	//! \~english Returns translated string.
+	//! \~russian Возвращает переведенную строку.
 	operator PIString() const { return PITranslator::tr(_s); }
+
+	//! \~english Returns translated string with context.
+	//! \~russian Возвращает переведенную строку с контекстом.
 	PIString operator()(const PIString & ctx = {}) const { return PITranslator::tr(_s, ctx); }
 
 private:
@@ -70,10 +105,20 @@ private:
 };
 
 
+//! \~english Context-aware string wrapper without translation (no-op).
+//! \~russian Контекстно-зависимая обертка строки без перевода (заглушка).
 class PIStringContextTrNoOp {
 public:
+	//! \~english Constructs wrapper from string.
+	//! \~russian Создает обертку из строки.
 	PIStringContextTrNoOp(PIString && s): _s(s) {}
+
+	//! \~english Returns original string.
+	//! \~russian Возвращает оригинальную строку.
 	operator PIString() const { return _s; }
+
+	//! \~english Returns original string with context.
+	//! \~russian Возвращает оригинальную строку с контекстом.
 	PIString operator()(const PIString & ctx = {}) const { return _s; }
 
 private: