merged AI doc, some new pages

libs/main/literals/piliterals_string.h

@@ -1,12 +1,12 @@
 /*! \file piliterals_string.h
  * \ingroup Core
  * \~\brief
- * \~english PIString C++11 literals
- * \~russian C++11 суффиксы PIString
+ * \~english PIString literal operators
+ * \~russian Операторы литералов для PIString
  */
 /*
     PIP - Platform Independent Primitives
-	PIString C++11 literals
+    PIString C++11 literals
     Ivan Pelipenko peri4ko@yandex.ru
 
     This program is free software: you can redistribute it and/or modify
@@ -28,16 +28,18 @@
 
 #include "pistring.h"
 
+//! \~\ingroup Core
 //! \~\brief
-//! \~english PIString from ASCII
-//! \~russian PIString из ASCII
+//! \~english Creates \a PIString from ASCII string literal.
+//! \~russian Создает \a PIString из ASCII-строкового литерала.
 inline PIString operator""_a(const char * v, size_t sz) {
 	return PIString::fromAscii(v, sz);
 }
 
+//! \~\ingroup Core
 //! \~\brief
-//! \~english PIString from UTF-8
-//! \~russian PIString из UTF-8
+//! \~english Creates \a PIString from UTF-8 string literal.
+//! \~russian Создает \a PIString из UTF-8 строкового литерала.
 inline PIString operator""_u8(const char * v, size_t sz) {
 	return PIString::fromUTF8(v, sz);
 }