doc core reference done

libs/main/core/pivariant.h

@@ -33,6 +33,23 @@
 #include "pimathmatrix.h"
 
 
+#ifdef DOXYGEN
+
+//! \relatesalso PIVariant
+//! \~\brief
+//! \~english Macro to register type for using in %PIVariant
+//! \~russian Макрос для регистрации типа для использования в %PIVariant
+#  define REGISTER_VARIANT(Typename)
+
+//! \relatesalso PIVariant
+//! \~\brief
+//! \~english Macro to register type with namespace for using in %PIVariant
+//! \~russian Макрос для регистрации типа с пространством имен для использования в %PIVariant
+#  define REGISTER_NS_VARIANT(Namespace, Typename)
+
+#endif
+
+
 #ifndef QNX
 #  define CUSTOM_PIVARIANT
 #endif
@@ -204,245 +221,316 @@ classname_to __PIVariantFunctions__<classname_from>::castVariant<classname_to>(c
 //! \ingroup Core
 //! \~\brief
 //! \~english Variant type.
+//! \~russian Вариантный тип.
 class PIP_EXPORT PIVariant {
 	friend PICout operator <<(PICout s, const PIVariant & v);
 	BINARY_STREAM_FRIEND(PIVariant);
 public:
 
-	//! Type of %PIVariant content
+	//! \~english Type of %PIVariant content
+	//! \~russian Тип содержимого %PIVariant
 	enum Type {
-		pivInvalid /** Invalid type , default type of empty contructor */ = 0 ,
-		pivBool /** bool */ ,
-		pivChar /** char */ ,
-		pivUChar /** uchar */ ,
-		pivShort /** short */ ,
-		pivUShort /** ushort */ ,
-		pivInt /** int */ ,
-		pivUInt /** uint */ ,
-		pivLLong /** llong */ ,
-		pivULLong /** ullong */ ,
-		pivFloat /** float */ ,
-		pivDouble /** double */ ,
-		pivLDouble /** ldouble */ ,
-		pivComplexd /** complexd */ ,
-		pivComplexld /** complexld */ ,
-		pivBitArray /** PIBitArray */ ,
-		pivByteArray /** PIByteArray */ ,
-		pivString /** PIString */ ,
+		pivInvalid    /** \~english Invalid type, default type of empty contructor \~russian Недействительный тип, также конструированный по умолчанию */ = 0 ,
+		pivBool       /** bool */ ,
+		pivChar       /** char */ ,
+		pivUChar      /** uchar */ ,
+		pivShort      /** short */ ,
+		pivUShort     /** ushort */ ,
+		pivInt        /** int */ ,
+		pivUInt       /** uint */ ,
+		pivLLong      /** llong */ ,
+		pivULLong     /** ullong */ ,
+		pivFloat      /** float */ ,
+		pivDouble     /** double */ ,
+		pivLDouble    /** ldouble */ ,
+		pivComplexd   /** complexd */ ,
+		pivComplexld  /** complexld */ ,
+		pivBitArray   /** PIBitArray */ ,
+		pivByteArray  /** PIByteArray */ ,
+		pivString     /** PIString */ ,
 		pivStringList /** PIStringList */ ,
-		pivTime /** PITime */ ,
-		pivDate /** PIDate */ ,
-		pivDateTime /** PIDateTime */ ,
+		pivTime       /** PITime */ ,
+		pivDate       /** PIDate */ ,
+		pivDateTime   /** PIDateTime */ ,
 		pivSystemTime /** PISystemTime */ ,
-		pivEnum /** PIVariantTypes::Enum */ ,
-		pivFile /** PIVariantTypes::File */ ,
-		pivDir /** PIVariantTypes::Dir */ ,
-		pivColor /** PIVariantTypes::Color */ ,
-		pivPoint /** PIPoint<double> */ ,
-		pivRect /** PIRect<double> */ ,
-		pivIODevice /** PIVariantTypes::IODevice */ ,
+		pivEnum       /** PIVariantTypes::Enum */ ,
+		pivFile       /** PIVariantTypes::File */ ,
+		pivDir        /** PIVariantTypes::Dir */ ,
+		pivColor      /** PIVariantTypes::Color */ ,
+		pivPoint      /** PIPoint<double> */ ,
+		pivRect       /** PIRect<double> */ ,
+		pivIODevice   /** PIVariantTypes::IODevice */ ,
 		pivMathVector /** PIMathVector<double> */ ,
 		pivMathMatrix /** PIMathMatrix<double> */ ,
-		pivLine /** PILine<double> */ ,
-		pivCustom /** Custom */ = 0xFF
+		pivLine       /** PILine<double> */ ,
+		pivCustom     /** \~english Custom \~russian Свой тип */ = 0xFF
 	};
 
-	//! Construct \a pivInvalid %PIVariant
+	//! \~english Construct \a pivInvalid %PIVariant
+	//! \~russian Создает \a pivInvalid %PIVariant
 	PIVariant();
 
+	//! \~english Contructs a copy of %PIVariant.
+	//! \~russian Создает копию %PIVariant.
 	PIVariant(const PIVariant & v);
 
+	//! \~english Move constructor.
+	//! \~russian Перемещающий конструктор.
 	PIVariant(PIVariant && v);
 
-	//! Constructs %PIVariant from string
+	//! \~english Constructs %PIVariant from string
+	//! \~russian Создает %PIVariant из строки.
 	PIVariant(const char * v) {initType(PIString(v));}
 
-	//! Constructs %PIVariant from boolean
+	//! \~english Constructs %PIVariant from boolean
+	//! \~russian Создает %PIVariant из логического значения.
 	PIVariant(const bool v) {initType(v);}
 
-	//! Constructs %PIVariant from char
+	//! \~english Constructs %PIVariant from char
+	//! \~russian Создает %PIVariant из символа.
 	PIVariant(const char v) {initType(v);}
 
-	//! Constructs %PIVariant from integer
+	//! \~english Constructs %PIVariant from integer
+	//! \~russian Создает %PIVariant из целого числа.
 	PIVariant(const uchar v) {initType(v);}
 
-	//! Constructs %PIVariant from integer
+	//! \~english Constructs %PIVariant from integer
+	//! \~russian Создает %PIVariant из целого числа.
 	PIVariant(const short v) {initType(v);}
 
-	//! Constructs %PIVariant from integer
+	//! \~english Constructs %PIVariant from integer
+	//! \~russian Создает %PIVariant из целого числа.
 	PIVariant(const ushort v) {initType(v);}
 
-	//! Constructs %PIVariant from integer
+	//! \~english Constructs %PIVariant from integer
+	//! \~russian Создает %PIVariant из целого числа.
 	PIVariant(const int & v) {initType(v);}
 
-	//! Constructs %PIVariant from integer
+	//! \~english Constructs %PIVariant from integer
+	//! \~russian Создает %PIVariant из целого числа.
 	PIVariant(const uint & v) {initType(v);}
 
-	//! Constructs %PIVariant from integer
+	//! \~english Constructs %PIVariant from integer
+	//! \~russian Создает %PIVariant из целого числа.
 	PIVariant(const llong & v) {initType(v);}
 
-	//! Constructs %PIVariant from integer
+	//! \~english Constructs %PIVariant from integer
+	//! \~russian Создает %PIVariant из целого числа.
 	PIVariant(const ullong & v) {initType(v);}
 
-	//! Constructs %PIVariant from float
+	//! \~english Constructs %PIVariant from float
+	//! \~russian Создает %PIVariant из вещественного числа.
 	PIVariant(const float & v) {initType(v);}
 
-	//! Constructs %PIVariant from double
+	//! \~english Constructs %PIVariant from double
+	//! \~russian Создает %PIVariant из вещественного числа.
 	PIVariant(const double & v) {initType(v);}
 
-	//! Constructs %PIVariant from long double
+	//! \~english Constructs %PIVariant from long double
+	//! \~russian Создает %PIVariant из вещественного числа.
 	PIVariant(const ldouble & v) {initType(v);}
 
-	//! Constructs %PIVariant from bit array
+	//! \~english Constructs %PIVariant from bit array
+	//! \~russian Создает %PIVariant из массива битов.
 	PIVariant(const PIBitArray & v) {initType(v);}
 
-	//! Constructs %PIVariant from byte array
+	//! \~english Constructs %PIVariant from byte array
+	//! \~russian Создает %PIVariant из массива байтов.
 	PIVariant(const PIByteArray & v) {initType(v);}
 
-	//! Constructs %PIVariant from string
+	//! \~english Constructs %PIVariant from string
+	//! \~russian Создает %PIVariant из строки.
 	PIVariant(const PIString & v) {initType(v);}
 
-	//! Constructs %PIVariant from strings list
+	//! \~english Constructs %PIVariant from strings list
+	//! \~russian Создает %PIVariant из массива строк.
 	PIVariant(const PIStringList & v) {initType(v);}
 
-	//! Constructs %PIVariant from time
+	//! \~english Constructs %PIVariant from time
+	//! \~russian Создает %PIVariant из времени.
 	PIVariant(const PITime & v) {initType(v);}
 
-	//! Constructs %PIVariant from date
+	//! \~english Constructs %PIVariant from date
+	//! \~russian Создает %PIVariant из даты.
 	PIVariant(const PIDate & v) {initType(v);}
 
-	//! Constructs %PIVariant from date and time
+	//! \~english Constructs %PIVariant from date and time
+	//! \~russian Создает %PIVariant из даты и времени.
 	PIVariant(const PIDateTime & v) {initType(v);}
 
-	//! Constructs %PIVariant from system time
+	//! \~english Constructs %PIVariant from system time
+	//! \~russian Создает %PIVariant из системного времени.
 	PIVariant(const PISystemTime & v) {initType(v);}
 
-	//! Constructs %PIVariant from enum
+	//! \~english Constructs %PIVariant from enum
+	//! \~russian Создает %PIVariant из перечисления.
 	PIVariant(const PIVariantTypes::Enum & v) {initType(v);}
 
-	//! Constructs %PIVariant from file
+	//! \~english Constructs %PIVariant from file
+	//! \~russian Создает %PIVariant из файла.
 	PIVariant(const PIVariantTypes::File & v) {initType(v);}
 
-	//! Constructs %PIVariant from dir
+	//! \~english Constructs %PIVariant from dir
+	//! \~russian Создает %PIVariant из директории.
 	PIVariant(const PIVariantTypes::Dir & v) {initType(v);}
 
-	//! Constructs %PIVariant from color
+	//! \~english Constructs %PIVariant from color
+	//! \~russian Создает %PIVariant из цвета.
 	PIVariant(const PIVariantTypes::Color & v) {initType(v);}
 
-	//! Constructs %PIVariant from IODevice
+	//! \~english Constructs %PIVariant from IODevice
+	//! \~russian Создает %PIVariant из IODevice.
 	PIVariant(const PIVariantTypes::IODevice & v) {initType(v);}
 
-	//! Constructs %PIVariant from point
+	//! \~english Constructs %PIVariant from point
+	//! \~russian Создает %PIVariant из точки.
 	PIVariant(const PIPointd & v) {initType(v);}
 
-	//! Constructs %PIVariant from rect
+	//! \~english Constructs %PIVariant from rect
+	//! \~russian Создает %PIVariant из прямоугольника.
 	PIVariant(const PIRectd & v) {initType(v);}
 
-	//! Constructs %PIVariant from line
+	//! \~english Constructs %PIVariant from line
+	//! \~russian Создает %PIVariant из линии.
 	PIVariant(const PILined & v) {initType(v);}
 
-	//! Constructs %PIVariant from MathVector
+	//! \~english Constructs %PIVariant from MathVector
+	//! \~russian Создает %PIVariant из MathVector.
 	PIVariant(const PIMathVectord & v) {initType(v);}
 
-	//! Constructs %PIVariant from MathMatrix
+	//! \~english Constructs %PIVariant from MathMatrix
+	//! \~russian Создает %PIVariant из MathMatrix.
 	PIVariant(const PIMathMatrixd & v) {initType(v);}
 
 
-	//! Set variant content and type to string
+	//! \~english Set variant content and type to string
+	//! \~russian Устанавливает значение и тип из строки
 	void setValue(const char * v) {setValue(PIString(v));}
 
-	//! Set variant content and type to boolean
+	//! \~english Set variant content and type to boolean
+	//! \~russian Устанавливает значение и тип из
 	void setValue(const bool v) {initType(v);}
 
-	//! Set variant content and type to char
+	//! \~english Set variant content and type to char
+	//! \~russian Устанавливает значение и тип из символа
 	void setValue(const char v) {initType(v);}
 
-	//! Set variant content and type to integer
+	//! \~english Set variant content and type to integer
+	//! \~russian Устанавливает значение и тип из целого числа
 	void setValue(const uchar v) {initType(v);}
 
-	//! Set variant content and type to integer
+	//! \~english Set variant content and type to integer
+	//! \~russian Устанавливает значение и тип из целого числа
 	void setValue(const short v) {initType(v);}
 
-	//! Set variant content and type to integer
+	//! \~english Set variant content and type to integer
+	//! \~russian Устанавливает значение и тип из целого числа
 	void setValue(const ushort v) {initType(v);}
 
-	//! Set variant content and type to integer
+	//! \~english Set variant content and type to integer
+	//! \~russian Устанавливает значение и тип из целого числа
 	void setValue(const int & v) {initType(v);}
 
-	//! Set variant content and type to integer
+	//! \~english Set variant content and type to integer
+	//! \~russian Устанавливает значение и тип из целого числа
 	void setValue(const uint & v) {initType(v);}
 
-	//! Set variant content and type to integer
+	//! \~english Set variant content and type to integer
+	//! \~russian Устанавливает значение и тип из целого числа
 	void setValue(const llong & v) {initType(v);}
 
-	//! Set variant content and type to integer
+	//! \~english Set variant content and type to integer
+	//! \~russian Устанавливает значение и тип из целого числа
 	void setValue(const ullong & v) {initType(v);}
 
-	//! Set variant content and type to float
+	//! \~english Set variant content and type to float
+	//! \~russian Устанавливает значение и тип из вещественного числа
 	void setValue(const float & v) {initType(v);}
 
-	//! Set variant content and type to double
+	//! \~english Set variant content and type to double
+	//! \~russian Устанавливает значение и тип из вещественного числа
 	void setValue(const double & v) {initType(v);}
 
-	//! Set variant content and type to long double
+	//! \~english Set variant content and type to long double
+	//! \~russian Устанавливает значение и тип из вещественного числа
 	void setValue(const ldouble & v) {initType(v);}
 
-	//! Set variant content and type to bit array
+	//! \~english Set variant content and type to bit array
+	//! \~russian Устанавливает значение и тип из массива битов
 	void setValue(const PIBitArray & v) {initType(v);}
 
-	//! Set variant content and type to byte array
+	//! \~english Set variant content and type to byte array
+	//! \~russian Устанавливает значение и тип из массива байтов
 	void setValue(const PIByteArray & v) {initType(v);}
 
-	//! Set variant content and type to string
+	//! \~english Set variant content and type to string
+	//! \~russian Устанавливает значение и тип из строки
 	void setValue(const PIString & v) {initType(v);}
 
-	//! Set variant content and type to strings list
+	//! \~english Set variant content and type to strings list
+	//! \~russian Устанавливает значение и тип из массива строк
 	void setValue(const PIStringList & v) {initType(v);}
 
-	//! Set variant content and type to time
+	//! \~english Set variant content and type to time
+	//! \~russian Устанавливает значение и тип из времени
 	void setValue(const PITime & v) {initType(v);}
 
-	//! Set variant content and type to date
+	//! \~english Set variant content and type to date
+	//! \~russian Устанавливает значение и тип из даты
 	void setValue(const PIDate & v) {initType(v);}
 
-	//! Set variant content and type to date and time
+	//!
+	//! \~english Set variant content and type to date and time
+	//! \~russian Устанавливает значение и тип из даты и времени
 	void setValue(const PIDateTime & v) {initType(v);}
 
-	//! Set variant content and type to system time
+	//! \~english Set variant content and type to system time
+	//! \~russian Устанавливает значение и тип из системного времени
 	void setValue(const PISystemTime & v) {initType(v);}
 
-	//! Set variant content and type to enum
+	//! \~english Set variant content and type to enum
+	//! \~russian Устанавливает значение и тип из перечисления
 	void setValue(const PIVariantTypes::Enum & v) {initType(v);}
 
-	//! Set variant content and type to file
+	//! \~english Set variant content and type to file
+	//! \~russian Устанавливает значение и тип из файла
 	void setValue(const PIVariantTypes::File & v) {initType(v);}
 
-	//! Set variant content and type to dir
+	//! \~english Set variant content and type to dir
+	//! \~russian Устанавливает значение и тип из директории
 	void setValue(const PIVariantTypes::Dir & v) {initType(v);}
 
-	//! Set variant content and type to color
+	//! \~english Set variant content and type to color
+	//! \~russian Устанавливает значение и тип из цвета
 	void setValue(const PIVariantTypes::Color & v) {initType(v);}
 
-	//! Set variant content and type to IODevice
+	//! \~english Set variant content and type to IODevice
+	//! \~russian Устанавливает значение и тип из IODevice
 	void setValue(const PIVariantTypes::IODevice & v) {initType(v);}
 
-	//! Set variant content and type to point
+	//! \~english Set variant content and type to point
+	//! \~russian Устанавливает значение и тип из точки
 	void setValue(const PIPointd & v) {initType(v);}
 
-	//! Set variant content and type to rect
+	//! \~english Set variant content and type to rect
+	//! \~russian Устанавливает значение и тип из прямоугольника
 	void setValue(const PIRectd & v) {initType(v);}
 
-	//! Set variant content and type to line
+	//! \~english Set variant content and type to line
+	//! \~russian Устанавливает значение и тип из линии
 	void setValue(const PILined & v) {initType(v);}
 
-	//! Set variant content and type to math vector
+	//! \~english Set variant content and type to math vector
+	//! \~russian Устанавливает значение и тип из вектора
 	void setValue(const PIMathVectord & v) {initType(v);}
 
-	//! Set variant content and type to math matrix
+	//! \~english Set variant content and type to math matrix
+	//! \~russian Устанавливает значение и тип из матрицы
 	void setValue(const PIMathMatrixd & v) {initType(v);}
 
 
-	//! Set current value from string without change type
+	//! \~english Set current value from string without change type
+	//! \~russian Устанавливает текущее значение из строки без изменения типа
 	void setValueFromString(const PIString & v);
 
 
@@ -472,102 +560,189 @@ public:
 	PIMathMatrixd toMathMatrix() const;
 
 
-	/** \brief Returns variant content as custom type
-	* \details In case of known types this function equivalent \a to<Type> function. \n
-	* Otherwise returns content as type T. */
+	//! \~\brief
+	//! \~english Returns variant content as custom type
+	//! \~russian Возвращает содержимое в качестве своего типа
+	//! \~\details
+	//! \~english
+	//! In case of known types this function equivalent \a to<Type> function. \n
+	//! Otherwise returns content as type T only if this type was set earlier.
+	//! \~russian
+	//! Для стандартных типов эквиваленстно методу \a to<Type>. \n
+	//! Для других возвращает тип T только если он был установлен ранее.
 	template<typename T>
 	T value() const {return getAsValue<T>(*this);}
 
-	//! Assign operator
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant & operator =(const PIVariant & v);
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant & operator =(PIVariant && v);
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant & operator =(const char * v) {setValue(PIString(v)); return *this;}
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant & operator =(const bool v) {setValue(v); return *this;}
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant & operator =(const char v) {setValue(v); return *this;}
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant & operator =(const uchar v) {setValue(v); return *this;}
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant & operator =(const short v) {setValue(v); return *this;}
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant & operator =(const ushort v) {setValue(v); return *this;}
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant & operator =(const int & v) {setValue(v); return *this;}
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant & operator =(const uint & v) {setValue(v); return *this;}
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant & operator =(const llong & v) {setValue(v); return *this;}
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant & operator =(const ullong & v) {setValue(v); return *this;}
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant & operator =(const float & v) {setValue(v); return *this;}
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant & operator =(const double & v) {setValue(v); return *this;}
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant & operator =(const ldouble & v) {setValue(v); return *this;}
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant & operator =(const PIBitArray & v) {setValue(v); return *this;}
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant & operator =(const PIByteArray & v) {setValue(v); return *this;}
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant & operator =(const PIString & v) {setValue(v); return *this;}
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant & operator =(const PIStringList & v) {setValue(v); return *this;}
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant & operator =(const PITime & v) {setValue(v); return *this;}
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant & operator =(const PIDate & v) {setValue(v); return *this;}
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant & operator =(const PIDateTime & v) {setValue(v); return *this;}
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant & operator =(const PISystemTime & v) {setValue(v); return *this;}
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant &  operator =(const PIVariantTypes::Enum & v) {setValue(v); return *this;}
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant &  operator =(const PIVariantTypes::File & v) {setValue(v); return *this;}
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant &  operator =(const PIVariantTypes::Dir & v) {setValue(v); return *this;}
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant &  operator =(const PIVariantTypes::Color & v) {setValue(v); return *this;}
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant &  operator =(const PIVariantTypes::IODevice & v) {setValue(v); return *this;}
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant &  operator =(const PIPointd & v) {setValue(v); return *this;}
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant &  operator =(const PIRectd & v) {setValue(v); return *this;}
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant &  operator =(const PILined & v) {setValue(v); return *this;}
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant &  operator =(const PIMathVectord & v) {setValue(v); return *this;}
-	//! Assign operator
+
+	//! \~english Assign operator.
+	//! \~russian Оператор присваивания.
 	PIVariant &  operator =(const PIMathMatrixd & v) {setValue(v); return *this;}
 
 
-	//! Compare operator
+	//! \~english Compare operator. Check type and content.
+	//! \~russian Оператор сравнения. Сравнивает тип и содержимое.
 	bool operator ==(const PIVariant & v) const;
-	//! Compare operator
+
+	//! \~english Compare operator. Check type and content.
+	//! \~russian Оператор сравнения. Сравнивает тип и содержимое.
 	bool operator !=(const PIVariant & v) const {return !(*this == v);}
 
 
-	//! Returns type of variant content
+	//! \~english Returns type of variant content.
+	//! \~russian Возвращает тип значения.
 	PIVariant::Type type() const {return _type;}
 
-	//! Returns type name of variant content
+	//! \~english Returns type name of variant content.
+	//! \~russian Возвращает имя типа значения.
 	PIString typeName() const;
 
 
-	//! Returns \b true if type is not Invalid
+	//! \~english Returns if type is not \a pivInvalid.
+	//! \~russian Возвращает не является ли тип \a pivInvalid.
 	bool isValid() const {return _type != PIVariant::pivInvalid;}
 
+	//! \~english Swaps with other %PIVariant.
+	//! \~russian Меняет с другим %PIVariant.
 	void swap(PIVariant & v);
 
 
-	/** \brief Returns new variant from custom type
-	* \details In case of known types this function equivalent \a PIVariant(T) constructors. \n
-	* Otherwise returns variant with content \a v and type Custom. */
+	//! \~\brief
+	//! \~english Returns new %PIVariant from custom type value.
+	//! \~russian Возвращает новый %PIVariant из значения своего типа.
+	//! \~\details
+	//! \~english
+	//! In case of known types this function equivalent \a PIVariant() constructors. \n
+	//! Otherwise returns variant with content "v" and type \a pivCustom.
+	//! \~russian
+	//! Для стандартных типов эквиваленстно конструктору \a PIVariant(). \n
+	//! Для других устанавливает содержимое из "v" и тип \a pivCustom.
 	template <typename T>
 	static PIVariant fromValue(const T & v) {
 		PIVariant ret;
@@ -596,10 +771,12 @@ public:
 	}
 
 
-	//! Returns type from name
+	//! \~english Returns type from its name.
+	//! \~russian Возвращает тип из его названия.
 	static PIVariant::Type typeFromName(const PIString & tname);
 
-	//! Returns type name
+	//! \~english Returns type name.
+	//! \~russian Возвращает имя типа.
 	static PIString typeName(PIVariant::Type type);
 
 private:
@@ -808,6 +985,9 @@ BINARY_STREAM_READ(PIVariant) {
 	return s;
 }
 
+//! \relatesalso PICout
+//! \~english Output operator to \a PICout
+//! \~russian Оператор вывода в \a PICout
 inline PICout operator <<(PICout s, const PIVariant & v) {
 	s.space(); s.saveAndSetControls(0);
 	s << "PIVariant(" << v.typeName();