ещё правки документации для PIVector и PIDeque

libs/main/containers/pideque.h

@@ -52,8 +52,15 @@
 //! This means that a pointer to an element of a PIDeque may be passed to any function
 //! that expects a pointer to an element of an array.
 //! To add elements you can use functions \a append() and \a insert(),
-//! to remove elements you can use functions \a remove() and \a clear().
-//! Change size by function \a resize().
+//! to remove elements you can use functions \a remove() and \a removeOne(), \a removeWhere().
+//! Change size by function \a resize() and \a assign().
+//! Items in an array are numbered, starting from zero.
+//! This number is called the item's index.
+//! So the first item has index 0, the last has index `size() - 1`.
+//! A set of various convenient functions is also available for the array,
+//! for example: \a indexOf, \a contains(), \a entries(), \a isEmpty(), \a isNotEmpty(),
+//! \a every(), \a any(), \a forEach(), \a indexWhere(), \a getRange(), \a sort(),
+//! \a map(), \a reduce(), \a filter(), \a flatten(), \a reshape() and others.
 //!
 //! The storage of the PIDeque is handled automatically,
 //! being expanded as needed.
@@ -78,8 +85,15 @@
 //! Это означает, что указатель на элемент PIDeque может передаваться в любую функцию,
 //! ожидающую указатель на элемент массива.
 //! Добавить элементы можно с помощью функции \a append() или \a insert(),
-//! а удалить с помощью \a remove() или \a clear().
-//! Изменить размер можно функцией \a resize().
+//! а удалить с помощью \a remove() или \a removeOne(), \a removeWhere().
+//! Изменить размер можно функцией \a resize() или \a assign().
+//! Массив индексируется с нуля:
+//! первый элемент массива имеет индекс, равный `0`,
+//! а индекс последнего элемента равен `size() - 1`.
+//! Также для массива доступен набор различных удобных функций,
+//! например: \a indexOf, \a contains(), \a entries(), \a isEmpty(), \a isNotEmpty(),
+//! \a every(), \a any(), \a forEach(), \a indexWhere(), \a getRange(), \a sort(),
+//! \a map(), \a reduce(), \a filter(), \a flatten(), \a reshape() и другие.
 //!
 //! Память PIDeque обрабатывается автоматически,
 //! расширяясь по мере необходимости.