picontainers.h doc

libs/main/containers/picontainers.h

@@ -115,8 +115,9 @@ template <typename C> _PIReverseWrapper<C> PIReverseWrap(const C & c) {return _P
  * \~english Macro for iterate any container
  * \~russian Макрос для перебора любых контейнеров
  * \~\deprecated
- * \~english Deprecated, using only for backward compatibility. Use "c++ range for".
+ * \~english Deprecated, using only for backward compatibility. Use
- * \~russian Устарело, используется только для обратной совместимости. Используйте "c++ range for".
+ * \~russian Устарело, используется только для обратной совместимости. Используйте
+ * \~ [C++ Range-based for loop](https://en.cppreference.com/w/cpp/language/range-for).
  * \~\details
  * \~english Get read/write access to each element of container.
  * Iterating in forward direction.
@@ -137,11 +138,56 @@ template <typename C> _PIReverseWrapper<C> PIReverseWrap(const C & c) {return _P
  * // 3
  * // 4
  * \endcode
+ * \sa \a piForeachC, \a piForeachR, \a piForeachRC
  */
 #define piForeach(i, c) for(i : c)
 
+/*! \brief
+ * \~english Macro for iterate any container
+ * \~russian Макрос для перебора любых контейнеров
+ * \~\deprecated
+ * \~english Deprecated, using only for backward compatibility. Use
+ * \~russian Устарело, используется только для обратной совместимости. Используйте
+ * \~ [C++ Range-based for loop](https://en.cppreference.com/w/cpp/language/range-for).
+ * \~\details
+ * \~english Get read only access to each element of container.
+ * Iterating in forward direction.
+ * \~russian Перебор всех элементов контейнера с доступом только на чтение.
+ * Перебор осуществляется в прямом порядке.
+ * \~ \sa \a piForeach, \a piForeachR, \a piForeachRC
+ */
 #define piForeachC(i, c) for(const i : c)
+
+/*! \brief
+ * \~english Macro for iterate any container
+ * \~russian Макрос для перебора любых контейнеров
+ * \~\deprecated
+ * \~english Deprecated, using only for backward compatibility. Use
+ * \~russian Устарело, используется только для обратной совместимости. Используйте
+ * \~ [C++ Range-based for loop](https://en.cppreference.com/w/cpp/language/range-for).
+ * \~\details
+ * \~english Get read/write access to each element of container.
+ * Iterating in backward direction.
+ * \~russian Перебор всех элементов контейнера с доступом на чтение и запись.
+ * Перебор осуществляется в обратном порядке.
+ * \~ \sa \a piForeach, \a piForeachC, \a piForeachRC
+ */
 #define piForeachR(i, c) for(i : PIReverseWrap(c))
+
+/*! \brief
+ * \~english Macro for iterate any container
+ * \~russian Макрос для перебора любых контейнеров
+ * \~\deprecated
+ * \~english Deprecated, using only for backward compatibility. Use
+ * \~russian Устарело, используется только для обратной совместимости. Используйте
+ * \~ [C++ Range-based for loop](https://en.cppreference.com/w/cpp/language/range-for).
+ * \~\details
+ * \~english Get read only access to each element of container.
+ * Iterating in backward direction. Also has alias **piForeachCR**
+ * \~russian Перебор всех элементов контейнера с доступом только на чтение.
+ * Перебор осуществляется в обратном порядке. Также можно писать **piForeachCR**
+ * \~ \sa \a piForeach, \a piForeachC, \a piForeachR
+ */
 #define piForeachRC(i, c) for(const i : PIReverseWrap(c))
 #define piForeachCR piForeachRC
 

libs/main/containers/picontainersmodule.h

@@ -18,10 +18,11 @@
 */
 /** \defgroup Containers
  * \~\brief
- * \~english This module contains various standart containers realization.
+ * This module contains various standart containers realization.
- * This includes
  * \~russian Модуль содержит основные классы контейнеров.
- * В него входят
+ * \~\details
+ * \~english This includes
+ * \~russian В него входят
  * \~ \a PIVector, \a PIDeque, \a PIMap, \a PISet,
  *  \a PIStack, \a PIQueue, \a PIVector2D.
  *