From d0be8e45432e11d16affa732e8794c289ea1a301 Mon Sep 17 00:00:00 2001
From: Martin Kojtal <martin.kojtal@arm.com>
Date: Fri, 28 Jun 2019 09:52:23 +0100
Subject: [PATCH] Watchdog: add missing docs doxygen

---
 drivers/Watchdog.h | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/drivers/Watchdog.h b/drivers/Watchdog.h
index cccf839237..49729ef4ff 100644
--- a/drivers/Watchdog.h
+++ b/drivers/Watchdog.h
@@ -38,13 +38,15 @@ namespace mbed {
  * Example:
  * @code
  *
- * Watchdog& watchdog = Watchdog::get_instance();
+ * Watchdog &watchdog = Watchdog::get_instance();
  * watchdog.start();
  *
  * while (true) {
  *    // Application code
  * }
  * @endcode
+ *
+ * @note Synchronization level: Interrupt safe
  * @ingroup drivers
  */
 class Watchdog : private NonCopyable<Watchdog>  {
@@ -65,6 +67,10 @@ public:
 
     /** Start the watchdog timer
      *
+     * If watchdog is already running, only callback is being updated (timeout can't be set to watchdog neither ticker).
+     *
+     *  @param func Callback to be invoked after timeout
+     *  @param timeout Ticker timeout to be kicking the watchdog
      *
      *  @return status true if the watchdog timer was started
      *                 successfully. assert if one of the input parameters is out of range for the current platform.
@@ -105,6 +111,10 @@ public:
      */
     bool is_running() const;
 
+    /** Kick watchdog
+     *
+     * This method is useful to control kicking by application
+     */
     void kick();
 
 private: