more ai generated doc with human review

libs/main/system/pisystemtests.h

@@ -17,22 +17,48 @@
     along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
 
-#ifndef PISYSTEMTESTS_H
-#define PISYSTEMTESTS_H
+//! \addtogroup System
+//! \{
+//! \file pisystemtests.h
+//! \brief System tests results
+//! \~english Provides access to system test results and timing information
+//! \~russian Предоставляет доступ к результатам системных тестов и информации о времени
+//! \details
+//! \~english This module contains functionality for reading system test results, including timing information
+//! \~russian Этот модуль содержит функциональность для чтения результатов системных тестов, включая информацию о времени
 
-#include "pibase.h"
+#ifndef PISYSTEMTESTS_H
+#  define PISYSTEMTESTS_H
+
+#  include "pibase.h"
 
 namespace PISystemTests {
+
+//! \~english Time resolution in nanoseconds
+//! \~russian Разрешение времени в наносекундах
 extern PIP_EXPORT long time_resolution_ns;
+
+//! \~english Time elapsed in nanoseconds
+//! \~russian Прошедшее время в наносекундах
 extern PIP_EXPORT long time_elapsed_ns;
+
+//! \~english Usleep offset in microseconds
+//! \~russian Смещение usleep в микросекундах
 extern PIP_EXPORT long usleep_offset_us;
 
+//! \~english System test reader class
+//! \~russian Класс чтения системных тестов
 class PIP_EXPORT PISystemTestReader {
 public:
+	//! \~english Constructor
+	//! \~russian Конструктор
 	PISystemTestReader();
 };
 
+//! \~english Global system test reader instance
+//! \~russian Глобальный экземпляр чтеца системных тестов
 extern PIP_EXPORT PISystemTestReader pisystestreader;
 } // namespace PISystemTests
 
 #endif // PISYSTEMTESTS_H
+//! \}