ecore_timer: Add docs for ecore_timer legacy functions

Summary:
Find docs of missing legacy functions
from 47cdbe3 and add them.

Test Plan: make doc

Reviewers: cedric, Hermet, segfaultxavi

Reviewed By: segfaultxavi

Subscribers: #reviewers, #committers

Tags: #efl

Differential Revision: https://phab.enlightenment.org/D7118

src/lib/ecore/Ecore_Legacy.h

@@ -255,10 +255,52 @@ EAPI Ecore_Timer *ecore_timer_loop_add(double in, Ecore_Task_Cb func, const void
  */
 EAPI void *ecore_timer_del(Ecore_Timer *timer);
 
+/**
+ * Pauses a running timer.
+ *
+ * @param timer The timer to be paused.
+ *
+ * @remarks The timer callback won't be called while the timer is paused. The remaining
+ *          time until the timer expires will be saved, so the timer can be resumed with
+ *          that same remaining time to expire, instead of expiring instantly.  Use
+ *          ecore_timer_thaw() to resume it.
+ *
+ * @note Nothing happens if the timer was already paused.
+ *
+ * @see ecore_timer_thaw()
+ */
 EAPI void ecore_timer_freeze(Ecore_Timer *timer);
 
+/**
+ * @brief Return whether the timer is freezing.
+ *
+ * @if MOBILE @since_tizen 3.0
+ * @elseif WEARABLE @since_tizen 3.0
+ * @endif
+ *
+ * @return True if the timer object is freezed, false otherwise.
+ *
+ * @see ecore_timer_freeze(), ecore_timer_thaw()
+ */
 EAPI Eina_Bool ecore_timer_freeze_get(Ecore_Timer *timer);
 
+/**
+ * @brief Resumes a frozen (paused) timer.
+ *
+ * @if MOBILE @since_tizen 2.3
+ * @elseif WEARABLE @since_tizen 2.3.1
+ * @endif
+ *
+ * @remarks The timer will be resumed from its previous relative position in time. That
+ *          means, if it had X seconds remaining until expire when it was paused, it will
+ *          be started now with those same X seconds remaining to expire again. But
+ *          notice that the interval time won't be touched by this call or by
+ *          ecore_timer_freeze().
+ *
+ * @param[in] timer The timer to be resumed.
+ *
+ * @see ecore_timer_freeze()
+ */
 EAPI void ecore_timer_thaw(Ecore_Timer *timer);
 
 #include "efl_loop_timer.eo.legacy.h"