 //  Copyright © 2015 Michael Chaffee. All rights reserved.
 //
 
-/*
-This custom control is a read-only UITextField which, when touched, raises a DatePickerPop and, after user entry,
-places that picker's value in its own text with its dateStyle property's style.
-*/
+/// This custom control is a read-only UITextField which, when touched, raises a DatePickerPop and, after user entry,
+/// places that picker's value in its own text with its dateStyle property's style.
+/// To use:
+/// - Wire the popupContainer outlet to the view controller which should contain the popup.
+/// - Wire the valueChanged event to the appropriate receiver AND/OR assign a delegate to receive textFieldDidEndEditing calls.
+/// - (optional) Set the dateStyle property if something other than .ShortStyle is desired.
 import UIKit
 
 public class DatePickerTextField: UITextField {

      forTextField.date = newDate
    }
    
    datePickerPop.pick(viewController, initDate: self.date, dataChanged: dataChangedCallback)
    
  }
  

      if newValue != _date {
        _date = newValue
        renderDate()
        sendValueChanged()
      }
    }
  }
