         }
     }
     
+    /// Controls when the current page will update.
+    ///
+    /// The default is `false`.
     @IBInspectable
     public var defersCurrentPageDisplay: Bool = false
     
+    /// Updates the current page indicator to the current page.
+    /// 
     public func updateCurrentPageDisplay() {
         updateCurrentPageDisplayWithAnimation()
     }
 
+    /// Use to size the control to fit a certain number of pages.
     public func sizeForNumberOfPages(pageCount: Int) -> CGSize {
         let width = pageIndicatorSize * CGFloat(pageCount) + pageIndicatorSpacing * CGFloat(max(0, pageCount - 1))
         return CGSize(width: max(7, width), height: defaultControlHeight)

        }
    }
    
    public func setCurrentPage(currentPage: CGFloat, animated: Bool = false) {
        let newPage = max(0, min(currentPage, CGFloat(numberOfPages - 1)))
        _currentPage = newPage
        updateCurrentPageDisplayWithAnimation(animated)
    }
    
    @IBInspectable
    public var numberOfPages: Int = 0 {
        didSet {

    
    // MARK: - Tint Color Overrides

    /// When set this property overrides the page indicator border color.
    ///
    /// The default is the control's `tintColor`.
    @IBInspectable
    public var pageIndicatorTintColor: UIColor?
    
    /// When set this property overrides the current page indicator's fill color.
    ///
    /// The default is the control's `tintColor`.
    @IBInspectable
    public var currentPageIndicatorTintColor: UIColor?
    
