more ai generated doc with human review

libs/main/state_machine/pistatemachine_state.h

@@ -1,12 +1,16 @@
-/*! \file pistatemachine_state.h
- * \ingroup StateMachine
- * \~\brief
- * \~english State machine node
- * \~russian Узел машины состояний
- */
+//! \addtogroup StateMachine
+//! \{
+//! \file pistatemachine_state.h
+//! \brief
+//! \~english State machine node
+//! \~russian Узел машины состояний
+//! \details
+//! \~english Contains state classes for building state machines
+//! \~russian Содержит классы состояний для построения машин состояний
+//! \}
 /*
     PIP - Platform Independent Primitives
-	State machine node
+    State machine node
     Ivan Pelipenko peri4ko@yandex.ru, Andrey Bychkov work.a.b@yandex.ru
 
     This program is free software: you can redistribute it and/or modify
@@ -208,6 +212,11 @@ private:
 };
 
 
+//! \~english Output stream operator for PIStateBase
+//! \~russian Оператор вывода потока для PIStateBase
+//! \param c Output stream
+//! \param s State to output
+//! \return Reference to output stream
 inline PICout operator<<(PICout c, PIStateBase * s) {
 	if (!s)
 		c << "state(nullptr)";