thread doc ru

libs/main/thread/pithreadnotifier.cpp

@@ -55,13 +55,18 @@ PIThreadNotifier::PIThreadNotifier() : cnt(0) {}
 
 //! \~\details
 //! \~english
-//! If \a notifyOnce() has been called before, then returns immediately.
+//! If \a notifyOnce() has been called before, then returns immediately.\n
 //! If \a notifyOnce() has been called "n" times, then returns immediately "n" times,
-//! but only if wait in one thread.
+//! but only if wait in one thread.\n
 //! If many threads waiting, then if \a notifyOnce() has been called "n" times,
-//! all threads total returns "n" times in random sequence.
+//! all threads total returns "n" times in undefined sequence.
 //!
 //! \~russian
+//! Если ранее был вызван \a notifyOnce(), то возвращает управление немедленно.\n
+//! Если ранее был вызван \a notifyOnce() "n" раз, то возвращает управление немедленно "n" раз,
+//! но только если ожидать одним потоком.\n
+//! Если ожидают несколько потоков, и \a notifyOnce() был вызван "n" раз,
+//! то все потоки суммарно вернут управление "n" раз в неопределенной последовательности.
 //!
 void PIThreadNotifier::wait() {
 	m.lock();
@@ -73,10 +78,12 @@ void PIThreadNotifier::wait() {
 
 //! \~\details
 //! \~english
-//! If many threads waiting, then notify randomly one.
+//! If many threads waiting, then notify randomly one.\n
 //! If call this "n" times, then notify any waiting threads totally "n" times.
 //!
 //! \~russian
+//! Если ожидают несколько потоков, то уведомляет один случайный.\n
+//! Если вызвать "n" раз, то все ожидающие потоки уведомятся суммарно "n" раз.
 void PIThreadNotifier::notifyOnce() {
 	m.lock();
 	cnt++;