     /**
      *  Determine if the tab can be selected.
      *
-     *  @param tabControl The instance of the tabs control.
-     *  @param item       The item representing the given tab.
+     *  - parameter tabControl: The instance of the tabs control.
+     *  - parameter item:       The item representing the given tab.
      *
-     *  @return A boolean value indicating whether the tab can be selected or not.
+     *  - returns: A boolean value indicating whether the tab can be selected or not.
      */
     optional func tabsControl(control: TabsControl, canSelectItem item: AnyObject) -> Bool
 

     *  If implemented, the delegate is informed that the tab has been renamed to the given title. Again, it is the
     *  delegate responsability to store the new title.
     *
     *  @param tabControl The instance of the tabs control.
     *  @param newTitle   The new title value.
     *  @param item       The item representing the given tab.
     */
    optional func tabsControl(control: TabsControl, setTitle newTitle: String, forItem item: AnyObject)
}

     *  If implemented, the delegate is informed that the tabs have been reordered. It is the delegate responsability
     *  to store the new order of items. If not stored, the tabs will recover their original order.
     *
     *  - parameter tabControl: The instance of the tabs control.
     *  - parameter items:      The array the items following the new orders.
     */
    optional func tabsControl(control: TabsControl, didReorderItems items: [AnyObject])

