add doc to previous commit

libs/main/containers/pideque.h

@@ -2505,6 +2505,11 @@ public:
 
 	//! \~english Divides an array into a two-dimensional array using the separator `separator`.
 	//! \~russian Разделяет массив на двумерный массив с помощью разделителя`separator`.
+	//! \~\code
+	//! PIDeque<int> v{1, 2, 3, 99, 4, 5, 99, 6};
+	//! piCout << v.split(99); // {{1, 2, 3}, {4, 5}, {6}}
+	//! \endcode
+	//! \~\sa \a splitBySize()
 	inline PIDeque<PIDeque<T>> split(const T & separator) const {
 		PIDeque<PIDeque<T>> ret;
 		if (isEmpty()) return ret;
@@ -2523,6 +2528,7 @@ public:
 
 	//! \~english Divides an array into a two-dimensional array in chunks of no more than `sz`.
 	//! \~russian Разделяет массив на двумерный массив по кускам не более чем `sz`.
+	//! \~\sa \a split()
 	inline PIDeque<PIDeque<T>> splitBySize(size_t sz) const {
 		PIDeque<PIDeque<T>> ret;
 		if (isEmpty() || sz == 0) return ret;

libs/main/containers/pivector.h

@@ -2423,6 +2423,11 @@ public:
 
 	//! \~english Divides an array into a two-dimensional array using the separator `separator`.
 	//! \~russian Разделяет массив на двумерный массив с помощью разделителя`separator`.
+	//! \~\code
+	//! PIVector<int> v{1, 2, 3, 99, 4, 5, 99, 6};
+	//! piCout << v.split(99); // {{1, 2, 3}, {4, 5}, {6}}
+	//! \endcode
+	//! \~\sa \a splitBySize()
 	inline PIVector<PIVector<T>> split(const T & separator) const {
 		PIVector<PIVector<T>> ret;
 		if (isEmpty()) return ret;
@@ -2441,6 +2446,7 @@ public:
 
 	//! \~english Divides an array into a two-dimensional array in chunks of no more than `sz`.
 	//! \~russian Разделяет массив на двумерный массив по кускам не более чем `sz`.
+	//! \~\sa \a split()
 	inline PIVector<PIVector<T>> splitBySize(size_t sz) const {
 		PIVector<PIVector<T>> ret;
 		if (isEmpty() || sz == 0) return ret;