pimap some doc

libs/main/containers/pimap.h

@@ -290,9 +290,13 @@ public:
 	//! то он будет создан конструктором по умолчанию и добавлен в массив
 	//! по ключу `key`, а затем возвращена ссылка на этот новый элемент.
 	//! \~\code
-	//! PIMap <PIString, PIString> m;
-	//! m[] =
-	//! piCout << m; //
+	//! PIMap <PIString, int> m;
+	//! m["огурец"] = 500;
+	//! piCout << m; // {огурец: 500}
+	//! m["лук"] = 25;
+	//! piCout << m; // {огурец: 500, лук: 25}
+	//! m["огурец"] = 350;
+	//! piCout << m; // {огурец: 350, лук: 25}
 	//! \endcode
 	//! \~\sa \a insert(), \a value(), \a key()
 	inline T & operator [](const Key & key) {
@@ -309,6 +313,8 @@ public:
 	//! \~\sa \a operator[](), \a value(), \a key()
 	inline T at(const Key & key) const {return value(key);}
 
+	//! \~english Remove element with key `key` from the array and return it.
+	//! \~russian Удаляет элемент с ключом `key` из массива и возвращает его.
 	inline T take(const Key & key) const {
 		bool f(false);
 		ssize_t i = _find(key, f);