doc ru, printf() before assert in containers

libs/main/thread/pispinlock.cpp

@@ -17,14 +17,49 @@
 	along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
 
-/** \class PISpinlock
- * \brief Spinlock
- * \details
- * \section PISpinlock_sec0 Synopsis
- * %PISpinlock provides synchronization blocks between several threads.
- * PISpinlock functionality similar to PIMutex, but working on atomic
- * type and \a lock() method wait with 100% CPU load.
- * \note
- * Use this type instead of PIMutex when less waiting time is more
- * important than CPU load!
- * */
+//! \addtogroup Thread
+//! \{
+//! \class PISpinlock pispinlock.h
+//!
+//! \~\brief
+//! \~english Fast and full-load lock
+//! \~russian Быстрая блокировка с полной нагрузкой
+//!
+//! \~\details
+//! \~english
+//! %PISpinlock provides synchronization blocks between several threads.
+//! PISpinlock functionality similar to PIMutex, but working on atomic
+//! type and \a lock() method wait with 100% CPU load.
+//!
+//! \~russian
+//!
+//! \~\note
+//! \~english
+//! Use this type instead of PIMutex when less waiting time is more
+//! important than CPU load!
+//!
+//! \~russian
+//!
+//! \}
+
+
+//! \addtogroup Thread
+//! \{
+//! \class PISpinlockLocker pispinlock.h
+//!
+//! \~\brief
+//! \~english %PISpinlock autolocker
+//! \~russian
+//!
+//!
+//! \~\details
+//! \~english
+//! When a PISpinlockLocker object is created, it attempts to lock the spinlock it is given, if "condition" true.
+//! When control leaves the scope in which the PISpinlockLocker object was created,
+//! the PISpinlockLocker is destructed and the spinlock is released, if "condition" true.
+//! If "condition" false this class do nothing.
+//! The PISpinlockLocker class is non-copyable.
+//!
+//! \~russian
+//!
+//! \}