new style of docs for Session.h

Author: L0rdLizard

src/protocol/Session.h

@@ -23,7 +23,6 @@ namespace STIP {
     public:
         /// \brief Обработка входящего пакета
         ///
-        /// Процесс обработки входящего пакетов
         /// Помечает, что пакет с данными получен
         ///
         /// \param packet пакет
@@ -129,10 +128,8 @@ namespace STIP {
         /// \brief Инициализация отправки
         ///
         /// Инициализация отправки сообщения
-        /// Установка команды, идентификатора сессии, идентификатора пакета и размера пакета
-        /// Копирование данных в пакет
-        /// Отправка пакета
-        /// Ожидание ответа
+        /// Установка команды, идентификатора сессии, идентификатора пакета и размера пакета.
+        /// Копирование данных в пакет, отправка пакета, ожидание ответа
         ///
         /// \return возвращает true
         bool initSend();
@@ -148,7 +145,6 @@ namespace STIP {
         ///
         /// Ожидание подтверждения
         ///
-        ///
         /// \return возвращает статус 5
         bool waitApproval();
 
@@ -166,10 +162,8 @@ namespace STIP {
 
         /// \brief Отправка части данных
         ///
-        /// Отправка части данных
-        /// Установка команды, идентификатора сессии и идентификатора части пакета
-        /// Копирование части данных в пакет
-        /// Отправка пакета
+        /// Установка команды, идентификатора сессии и идентификатора части пакета.
+        /// Копирование части данных в пакет, отправка пакета
         ///
         /// \param packet_id - идентификатор пакета
         void sendPart(size_t packet_id);
@@ -194,7 +188,6 @@ namespace STIP {
 
         /// \brief Обработка входящего пакета ?
         ///
-        /// Процесс обработки входящего пакета
         /// Проверка команды пакета
         ///
         /// \param packet - пакет
@@ -240,7 +233,7 @@ namespace STIP {
     public:
         /// \brief Добавление сессии
         ///
-        /// Добавление сессии в список сессий
+        /// Добавление сессии в список сессий.
         /// Проверка наличия уже сессии с таким идентификатором
         ///
         /// \param session
@@ -255,7 +248,7 @@ namespace STIP {
 
         /// \brief Получение сессии
         ///
-        /// Получение сессии по идентификатору
+        /// Получение сессии по идентификатору.
         /// Проверка наличия сессии с таким идентификатором
         ///
         /// \param id - идентификатор сессии
@@ -264,8 +257,8 @@ namespace STIP {
 
         /// \brief Генерация идентификатора сессии
         ///
-        /// Генерация идентификатора сессии
-        /// Генерация случайного числа в диапазоне от 0 до 1000000
+        /// Генерация идентификатора сессии.
+        /// Генерация случайного числа в диапазоне от 0 до 1000000.
         /// Проверка наличия сессии с таким идентификатором
         ///
         /// \return сгенерированный идентификатор сессии