     /**
      initlaize bar code reader view with the specified decoder. this is for IB
      
-     @param coder: NSCoder instance to decode the view.
-     
-     @return a new instance of bar code reader view.
+     - Parameters:
+     - coder: NSCoder instance to decode the view.
+     
+     Returns: a new instance of bar code reader view.
      */
     required public init?(coder aDecoder: NSCoder) {
         super.init(coder: aDecoder)
         self.setupInitializers()
     }
-        
+    
+    /**
+     overriden methods from UIView
+     */
     public override func didMoveToSuperview() {
         super.didMoveToSuperview()
         self.barcodeWillMoveToSuperView()
     }
     
     //MARK: - public functions
+    
+    /**
+    start looking for barcodes. call this method when you are ready to capture some codes
+    */
     public func startCapturing() {
         if nil != self.captureSession{
             self.captureSession.startRunning()
         }
     }
     
+    /**
+     stop looking for barcodes. call this method when you want to stop capturing barcodes
+     */
     public func stopCapturing() {
         if nil != self.captureSession{
             self.captureSession.stopRunning()

    case ITF14Code
    case DataMatrixCode
    
    public var description: String {
        get{
            switch self {

    }
}

/// a UIView subclass which can reads barcodes. :)
public class BarcodeReaderView: UIView {
    
    /* public Variables */
    
    ///the delegate which must conform to `BarcodeReaderViewDelegate` protocol
    public var delegate: BarcodeReaderViewDelegate?
    
    /// barcodes type you would like to scan with this instance
    public var barCodeTypes: [BarCodeType]? {
        didSet {
            if nil != self.captureSession {
