Merge pull request #5045 from maciejbocianski/ticker_fix

Ticker class description update - small interval warning

Author: theotherjimmy

drivers/Ticker.h

@@ -101,6 +101,11 @@ class Ticker : public TimerEvent, private NonCopyable<Ticker> {
      *
      *  @param func pointer to the function to be called
      *  @param t the time between calls in micro-seconds
+     *
+     *  @note setting @a t to a value shorter that it takes to process the ticker callback
+     *  will cause the system to hang. Ticker callback will be called constantly with no time
+     *  for threads scheduling.
+     *
      */
     void attach_us(Callback<void()> func, us_timestamp_t t) {
         // lock only for the initial callback setup