Update descriptions of undocumented methods

Author: bcylin

Source/KeyboardDismissTextField/ICKeyboardDismissAccessoryView.swift

@@ -26,16 +26,18 @@
 
 import UIKit
 
+/// A customized keyboard accessory view with a dismiss button.
 @IBDesignable
 public class ICKeyboardDismissAccessoryView: UIView {
 
   /// The background color of the button to dismiss keyboard.
-  @IBInspectable var buttonColor: UIColor = Constants.ButtonColor {
+  @IBInspectable public var buttonColor: UIColor = Constants.ButtonColor {
     didSet {
       dismissButton.backgroundColor = buttonColor
     }
   }
 
+  /// The button to dismiss keyboard.
   public private(set) lazy var dismissButton: UIButton = {
     let _button = UIButton()
     let resources = NSBundle(forClass: self.dynamicType)
@@ -57,11 +59,13 @@ public class ICKeyboardDismissAccessoryView: UIView {
 
   // MARK: - Initialization
 
+  /// Initializes and returns a newly allocated view object with the specified frame rectangle.
   public override init(frame: CGRect) {
     super.init(frame: frame)
     setUpSubviews()
   }
 
+  /// Returns an object initialized from data in a given unarchiver.
   public required init?(coder aDecoder: NSCoder) {
     super.init(coder: aDecoder)
     setUpSubviews()

Source/KeyboardDismissTextField/ICKeyboardDismissTextField.swift

@@ -26,9 +26,11 @@
 
 import UIKit
 
+/// A text field that has a button to dismiss keyboard on the input accessory view.
 @IBDesignable
 public class ICKeyboardDismissTextField: UITextField {
 
+  /// The custom input accessory view with a button to dismiss keyboard.
   @IBOutlet public var keyboardAccessoryView: ICKeyboardDismissAccessoryView! {
     didSet {
       if UI_USER_INTERFACE_IDIOM() != .Phone { return }
@@ -39,11 +41,13 @@ public class ICKeyboardDismissTextField: UITextField {
 
   // MARK: - Initialization
 
+  /// Initializes and returns a newly allocated view object with the specified frame rectangle.
   public override init(frame: CGRect) {
     super.init(frame: frame)
     setUpAccessoryView()
   }
 
+  /// Returns an object initialized from data in a given unarchiver.
   public required init?(coder aDecoder: NSCoder) {
     super.init(coder: aDecoder)
     setUpAccessoryView()

Source/TokenField/ICTokenField.swift

@@ -41,15 +41,13 @@ import UIKit
 }
 
 
-////////////////////////////////////////////////////////////////////////////////
-
-
+/// A text field that groups input texts with delimiters.
 @IBDesignable
 public class ICTokenField: UIView, UITextFieldDelegate, ICBackspaceTextFieldDelegate {
 
   // MARK: - Public Properties
 
-  /// The receiver’s delegate.
+  /// The receiver's delegate.
   public weak var delegate: ICTokenFieldDelegate?
 
   /// Characters that completes a new token, defaults are whitespace and commas.
@@ -117,7 +115,7 @@ public class ICTokenField: UIView, UITextFieldDelegate, ICBackspaceTextFieldDele
     }
   }
 
-  /// Customized attributes for tokens in the normal state, e.g. NSFontAttributeName and NSForegroundColorAttributeName.
+  /// Customized attributes for tokens in the normal state, e.g. `NSFontAttributeName` and `NSForegroundColorAttributeName`.
   public var normalTokenAttributes: [String: NSObject]? {
     didSet {
       tokens.forEach { $0.normalTextAttributes = normalTokenAttributes ?? [:] }
@@ -211,11 +209,13 @@ public class ICTokenField: UIView, UITextFieldDelegate, ICBackspaceTextFieldDele
 
   // MARK: - Initialization
 
+  /// Initializes and returns a newly allocated view object with the specified frame rectangle.
   public override init(frame: CGRect) {
     super.init(frame: frame)
     setUpSubviews()
   }
 
+  /// Returns an object initialized from data in a given unarchiver.
   public required init?(coder aDecoder: NSCoder) {
     super.init(coder: aDecoder)
     setUpSubviews()
@@ -365,9 +365,7 @@ public class ICTokenField: UIView, UITextFieldDelegate, ICBackspaceTextFieldDele
 
   // MARK: - Private Methods
 
-  /**
-  Returns true if any highlighted token is found and removed, otherwise false.
-  */
+  /// Returns true if any highlighted token is found and removed, otherwise false.
   private func removeHighlightedToken() -> Bool {
     for (index, token) in tokens.enumerate() {
       if token.highlighted {