             currentPlayer.enableRate = v
         }
     }
-
+    /**
+    Refreshes the average and peak power values for all channels of an audio player.
+    To obtain current audio power values, you must call this method before calling averagePowerForChannel: or peakPowerForChannel:.
+    
+        let t = NSTimer.scheduledTimerWithTimeInterval(1.0/60.0,
+                    target: self,
+                    selector: "update",
+                    userInfo: nil,
+                    repeats: true)
+
+        let ap = C4AudioPlayer("audioTrackFileName")
+        ap.meteringEnabled = true
+
+        func update() {
+            ap.updateMeters()
+        }
+    */
     public func updateMeters() {
         currentPlayer.updateMeters()
     }
 
+    /**
+    Returns the average power for a given channel, in decibels, for the sound being played.
+    
+        func update() {
+            let av = player.averagePower(channel: 0)
+        }
+    :param: channelNumber The audio channel whose average power value you want to obtain.
+    :returns: A floating-point representation, in decibels, of a given audio channel’s current average power.
+    */
     public func averagePower(channel: Int) -> Double {
         return Double(currentPlayer.averagePowerForChannel(channel))
     }
 
+    /**
+    Returns the peak power for a given channel, in decibels, for the sound being played.
+
+        func update() {
+            let pk = player.peakPower(channel: 0)
+        }
+
+    :param: channelNumber The audio channel whose peak power value you want to obtain.
+    :returns: A floating-point representation, in decibels, of a given audio channel’s current peak power.    
+    */
     public func peakPower(channel: Int) -> Double {
         return Double(currentPlayer.peakPowerForChannel(channel))
     }

        }
    }

    public var enableRate : Bool {
        get {
            return currentPlayer.enableRate

        }
    }

    /**
    A Boolean value that specifies the audio-level metering on/off state for the audio player.
    The default value for the meteringEnabled property is off (Boolean false). Before using metering for an audio player, you need to enable it by setting this property to true. If player is an audio player instance variable of your controller class, you enable metering as shown here:

        let ap = C4AudioPlayer("audioTrackFileName")
        ap.meteringEnabled = true

    */
    public var meteringEnabled : Bool {
        get {
            return currentPlayer.meteringEnabled
