      *  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.
+     *  - parameter tabControl: The instance of the tabs control.
+     *  - parameter newTitle:   The new title value.
+     *  - parameter item:       The item representing the given tab.
      */
     optional func tabsControl(control: TabsControl, setTitle newTitle: String, forItem item: AnyObject)
 }

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


     *  Return `true` if the tab is allowed to be reordered (by being dragged with the mouse).
     *  This method has no effect if the one below is not implemented.
     *
     *  - parameter tabControl: The instance of the tabs control.
     *  - parameter item:       The item representing the given tab.
     *
     *  - returns: A boolean value indicating whether the tab can be reordered or not.
     */
    optional func tabsControl(control: TabsControl, canReorderItem item: AnyObject) -> Bool

