merged AI doc, some new pages

libs/main/thread/pithreadnotifier.h

@@ -1,13 +1,12 @@
-/*! \file pithreadnotifier.h
- * \ingroup Thread
- * \~\brief
- * \~english Class for simple notify and wait in different threads
- * \~russian Класс для простого уведомления и ожидания в различных потоках
- */
+//! \~\file pithreadnotifier.h
+//! \~\ingroup Thread
+//! \~\brief
+//! \~english Counting notification helper for coordination between threads
+//! \~russian Счетный помощник уведомления для координации между потоками
 /*
     PIP - Platform Independent Primitives
     Class for simply notify and wait in different threads
-    Andrey Bychkov work.a.b@yandex.ru
+	Ivan Pelipenko peri4ko@yandex.ru
 
     This program is free software: you can redistribute it and/or modify
     it under the terms of the GNU Lesser General Public License as published by
@@ -29,6 +28,19 @@
 #include "piconditionvar.h"
 
 
+//! \~\ingroup Thread
+//! \~\brief
+//! \~english Thread notifier class for synchronization between threads.
+//! \~russian Класс уведомления потоков для синхронизации между потоками.
+//! \~\details
+//! \~english
+//! Each \a notify() stores one pending wake-up. A later \a wait() or
+//! \a waitFor() consumes one stored notification; with multiple waiters the
+//! resume order is unspecified.
+//! \~russian
+//! Каждый вызов \a notify() сохраняет одно ожидающее пробуждение. Последующий
+//! \a wait() или \a waitFor() потребляет одно сохраненное уведомление; при
+//! нескольких ожидающих потоках порядок возобновления не определен.
 class PIP_EXPORT PIThreadNotifier {
 public:
 	PIThreadNotifier();