      *  Return `true` if you allow the editing of the title of the tab. By default, titles are not editable.
      *  This method has no effect if the one below is not implemented.
      *
-     *  @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 title can be edited or not.
+     *  - returns: A boolean value indicating whether the tab title can be edited or not.
      */
     optional func tabsControl(control: TabsControl, canEditTitleOfItem item: AnyObject) -> Bool
 

     *  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.
     *
     *  @param tabControl The instance of the tabs control.
     *  @param items      The array the items following the new orders.
     */
    optional func tabsControl(control: TabsControl, didReorderItems items: [AnyObject])


     *  If implemented, the delegate is informed that the selected tab did change.
     *  See also TabsControlSelectionDidChangeNotification
     *
     *  - parameter tabControl: The instance of the tabs control.
     */
    optional func tabsControlDidChangeSelection(control: TabsControl)

