From 28ed18d85e2bb0ac1f5f4f7e4505eee356834537 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Lo=C3=AFc=20Collignon?= Date: Wed, 8 Mar 2017 12:44:50 +0100 Subject: [PATCH] Change doxygen comments MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit Change-Id: Ia635a7483e2fcda3b98fd3d3b3f7e996d26926d0 Signed-off-by: Loïc Collignon --- src/can/can-bus.hpp | 57 ++++++++++------------------ src/diagnostic/active-diagnostic-request.hpp | 1 - 2 files changed, 20 insertions(+), 38 deletions(-) diff --git a/src/can/can-bus.hpp b/src/can/can-bus.hpp index 3ae41c94..4c265286 100644 --- a/src/can/can-bus.hpp +++ b/src/can/can-bus.hpp @@ -126,46 +126,29 @@ class can_bus_dev_t { int send_can_message(can_message_t& can_msg); }; -/** TODO: implement this function as method into can_bus class - * @fn void pre_initialize(can_bus_dev_t* bus, bool writable, can_bus_dev_t* buses, const int busCount); - * @brief Pre initialize actions made before CAN bus initialization - * - * @param[in] can_bus_dev_t bus - A CanBus struct defining the bus's metadata - * @param[in] bool writable - configure the controller in a writable mode. If false, it will be - * configured as "listen only" and will not allow writes or even CAN ACKs. - * @param[in] buses - An array of all CAN buses. - * @param[in] int busCount - The length of the buses array. - */ +/// TODO: implement this function as method into can_bus class +/// @brief Pre initialize actions made before CAN bus initialization +/// @param[in] bus A CanBus struct defining the bus's metadata +/// @param[in] writable Configure the controller in a writable mode. If false, it will be configured as "listen only" and will not allow writes or even CAN ACKs. +/// @param[in] buses An array of all CAN buses. +/// @param[in] busCount The length of the buses array. void pre_initialize(can_bus_dev_t* bus, bool writable, can_bus_dev_t* buses, const int busCount); -/** TODO: implement this function as method into can_bus class - * @fn void post_initialize(can_bus_dev_t* bus, bool writable, can_bus_dev_t* buses, const int busCount); - * @brief Post-initialize actions made after CAN bus initialization - * - * @param[in] bus - A CanBus struct defining the bus's metadata - * @param[in] writable - configure the controller in a writable mode. If false, it will be - * configured as "listen only" and will not allow writes or even CAN ACKs. - * @param[in] buses - An array of all CAN buses. - * @param[in] busCount - The length of the buses array. - */ +/// TODO: implement this function as method into can_bus class +/// @brief Post-initialize actions made after CAN bus initialization +/// @param[in] bus A CanBus struct defining the bus's metadata +/// @param[in] writable Configure the controller in a writable mode. If false, it will be configured as "listen only" and will not allow writes or even CAN ACKs. +/// @param[in] buses An array of all CAN buses. +/// @param[in] busCount The length of the buses array. void post_initialize(can_bus_dev_t* bus, bool writable, can_bus_dev_t* buses, const int busCount); -/** TODO: implement this function as method into can_bus class - * @fn bool isBusActive(can_bus_dev_t* bus); - * @brief Check if the device is connected to an active CAN bus, i.e. it's - * received a message in the recent past. - * - * @return true if a message was received on the CAN bus within - * CAN_ACTIVE_TIMEOUT_S seconds. - */ +/// TODO: implement this function as method into can_bus class +/// @brief Check if the device is connected to an active CAN bus, i.e. it's received a message in the recent past. +/// @return true if a message was received on the CAN bus within CAN_ACTIVE_TIMEOUT_S seconds. bool isBusActive(can_bus_dev_t* bus); -/** TODO: implement this function as method into can_bus class - * - * @fn void logBusStatistics(can_bus_dev_t* buses, const int busCount); - * @brief Log transfer statistics about all active CAN buses to the debug log. - * - * @param[in] buses - an array of active CAN buses. - * @param[in] busCount - the length of the buses array. - */ -void logBusStatistics(can_bus_dev_t* buses, const int busCount); \ No newline at end of file +/// TODO: implement this function as method into can_bus class +/// @brief Log transfer statistics about all active CAN buses to the debug log. +/// @param[in] buses An array of active CAN buses. +/// @param[in] busCount The length of the buses array. +void logBusStatistics(can_bus_dev_t* buses, const int busCount); diff --git a/src/diagnostic/active-diagnostic-request.hpp b/src/diagnostic/active-diagnostic-request.hpp index 55b55f5a..fe237d4b 100644 --- a/src/diagnostic/active-diagnostic-request.hpp +++ b/src/diagnostic/active-diagnostic-request.hpp @@ -78,5 +78,4 @@ class active_diagnostic_request_t { FrequencyClock timeoutClock_; /*!< FrequencyClock timeoutClock_ - A FrequencyClock struct to monitor how long it's been since * this request was sent.*/ public: - }; -- 2.16.6