Коррекции по синтаксису и doxygen

Inc/modbus.h

@@ -1,20 +1,22 @@
 /**
-******************************************************************************
+*******************************************************************************
 * @file modbus.h
 * @brief Главный заголовочный файл Modbus библиотеки
-******************************************************************************
+*******************************************************************************
 @addtogroup MODBUS Modbus tools
-******************************************************************************
+@brief Библиотека реализующая протокол Modbus
+*******************************************************************************
 @addtogroup MODBUS_FUNCTIONS Main API for Modbus Library
 @ingroup    MODBUS
+@brief Публичные функции библиотеки
 @{
-******************************************************************************
+*******************************************************************************
 * @details
 Объединяющий файл для подключения всей функциональности Modbus.
 Подключает все необходимые модули:
 
 
-@section  init Инструкция по подключению
+@section Start Инструкция по подключению
 Для корректной работы надо:
 - Подключить обработчики RS_UART_Handler(), RS_TIM_Handler(), в соответствубщие 
   низкоуровневые прерывания UART_IRQHandler, TIM_IRQHandler вместо HAL'овского обработчика
@@ -23,20 +25,20 @@
 
 - Инициализировать хендл мобдас. По умолчанию глобально создается hmodbus1
 - После для запуска Modbus:
-  @verbatim
+  @code
   //----------------Слейв модбас----------------//
   #include "modbus.h"
 
   MODBUS_FirstInit(&hmodbus1, &huart1, &htim3);
   MODBUS_Config(&hmodbus1, MODBUS_DEVICE_ID, MODBUS_TIMEOUT, MODBUS_MODE_SLAVE);
   MODBUS_SlaveStart(&hmodbus1, NULL);
-  @endverbatim
-  @verbatim
+  @endcode
+  @code
   //----------------Мастер модбас----------------//
   #include "modbus.h"
 
   MODBUS_FirstInit(&hmodbus1, &huart1, &htim3);
-  MODBUS_Config(&hmodbus1, 0, 1000, MODBUS_MODE_MASTER);
+  MODBUS_Config(&hmodbus1, 0, MODBUS_TIMEOUT, MODBUS_MODE_MASTER);
   // Запрос на 1 ID, считать холдинг регистры с 0 адреса 10 штук
   RS_MsgTypeDef msg = MB_REQUEST_READ_HOLDING_REGS(1, 0, 10);
   MODBUS_MasterRequest(&hmodbus1, &msg, &callback_func);
@@ -56,10 +58,10 @@
       }
     }
   }
-  @endverbatim
+  @endcode
 
 
-@section  Подключаемые модули:
+@section modules Подключаемые модули:
 - rs_message.h - работа с uart
 - modbus_core.h - базовые определения
 - modbus_coils.h - работа с дискретными выходами
@@ -69,7 +71,7 @@
 - modbus_diag.h - диагностика modbus
 
 
-@section  Структура данных Modbus
+@section data Структура данных Modbus
 
 #### Holding/Input Registers:
 - Регистры — 16-битные слова. Доступ к регистрам осуществляется через указатель.  
@@ -108,11 +110,11 @@
 
   
 #ifdef MODBUS_ENABLE_MASTER
-#define MODBUS_MODE_MASTER 1
+#define MODBUS_MODE_MASTER 1  ///< Псевдо-enum: Режим мастер
 #endif
 
 #ifdef MODBUS_ENABLE_SLAVE
-#define MODBUS_MODE_SLAVE 0
+#define MODBUS_MODE_SLAVE 0   ///< Псевдо-enum: Режим слейв
 #endif
 
 /////////////////////////////////////////////////////////////////////