doc, small fixes

libs/main/io_devices/pifile.cpp

@@ -69,25 +69,44 @@
 #  define _stat_link_      lstat64
 #endif
 
-/*! \class PIFile
- * \brief Local file
- *
- * \section  PIFile_sec0 Synopsis
- * This class provide access to local file. You can manipulate
- * binary content or use this class as text stream. To binary
- * access there are function \a read(), \a write(), and many
- * \a writeBinary() functions. For write variables to file in
- * their text representation threr are many "<<" operators.
- *
- * \section  PIFile_sec1 Position
- * Each opened file has a read/write position - logical position
- * in the file content you read from or you write to. You can
- * find out current position with function \a pos(). Function
- * \a seek(llong position) move position to position "position",
- * \a seekToBegin() move position to the begin of file,
- * \a seekToEnd() move position to the end of file.
- *
- */
+
+//! \class PIFile pifile.h
+//! \details
+//! \~english \section PIFile_sec0 Synopsis
+//! \~russian \section PIFile_sec0 Краткий обзор
+//! \~english
+//!
+//! This class provide access to local file. You can manipulate
+//! binary content or use this class as text stream. To binary
+//! access there are function \a read(), \a write(), and many
+//! \a writeBinary() functions. For write and read variables to file in
+//! their text representation there are many "<<" and ">>" operators.
+//!
+//! \~russian
+//! Этот класс предоставляет доступ к локальному файлу. Можно
+//! работать на байтовом уровне, либо использовать его как
+//! текстовый поток. Для байтового доступа используются методы
+//! \a read(), \a write(), и много \a writeBinary() методов.
+//! Для записи и чтения переменных в текстовом представлении
+//! используются операторы "<<" и ">>".
+//!
+//! \~english \section PIFile_sec1 Position
+//! \~russian \section PIFile_sec1 Позиция
+//! \~english
+//! Each opened file has a read/write position - logical position
+//! in the file content you read from or you write to. You can
+//! find out current position with function \a pos(). Function
+//! \a seek(llong position) move position to position "position",
+//! \a seekToBegin() move position to the begin of file,
+//! \a seekToEnd() move position to the end of file.
+//!
+//! \~russian
+//! Каждый файл имеет позицию чтения/записи - логическое положение
+//! в содержимом файла, откуда производится чтение или запись.
+//! Узнать текущую позицию можно с помощью метода \a pos().
+//! Метод \a seek(llong position) перемещает позицию на указанную,
+//! \a seekToBegin() перемещает её в начало файла, а \a seekToEnd() - в конец.
+//!
 
 REGISTER_DEVICE(PIFile)