@@ -13,20 +13,27 @@
  * LICENSE.GPLv2 or LICENSE.GPLv3 respectively included in the packaging of this
  * file.
  */
 
 #import "OFObject.h"
+
+/*! @file */
 
 @class OFTimer;
 @class OFDate;
 @class OFRunLoop;
 #ifdef OF_HAVE_THREADS
 @class OFCondition;
 #endif
 
 #ifdef OF_HAVE_BLOCKS
-typedef void (^of_timer_block_t)(OFTimer*);
+/*!
+ * @brief A block to execute when a timer fires.
+ *
+ * @param timer The timer which fired
+ */
+typedef void (^of_timer_block_t)(OFTimer *timer);
 #endif
 
 /*!
  * @brief A class for creating and firing timers.
  */