doc ru, printf() before assert in containers

libs/main/thread/pithreadnotifier.h

@@ -33,17 +33,12 @@ class PIP_EXPORT PIThreadNotifier {
 public:
 	PIThreadNotifier();
 
-	//! Start waiting, return if other thread call \a notifyOnce().
-	//! If \a notifyOnce() has been called before, then returns immediately.
-	//! If notifyOnce() has been called "n" times, then returns immediately "n" times,
-	//! but only if wait in one thread.
-	//! If many threads waiting, then If notifyOnce() has been called "n" times,
-	//! All threads total returns "n" times in random sequence.
+	//! \~english Start waiting, return if other thread call \a notifyOnce()
+	//! \~russian Начать ожидание, продолжает когда другой поток вызовет \a notifyOnce()
 	void wait();
 
-	//! Notify one waiting thread, wich waiting on \a wait() function.
-	//! If many threads waiting, then notify randomly one.
-	//! If call this "n" times, then notify any waiting threads totally "n" times.
+	//! \~english Notify one waiting thread, which waiting on \a wait() function
+	//! \~russian Уведомить один из ожидающих потоков, которые висят на методе \a wait()
 	void notifyOnce();
 
 private: