     import mx.messaging.messages.MessagePerformanceInfo;
     
     /** 
-     * The MessagePerformanceUtils class is used to retrieve various metrics about
+     * The MessagePerformanceUtils utility class is used to retrieve various metrics about
      * the sizing and timing of a message sent from a client to the server and its 
      * response message, as well as pushed messages from the server to the client.  
-     *
-     * <p>Metrics are gathered when the following properties on the channel are set to <code>true</code>:
-     * <code>&lt;record-message-times&gt;</code> enables capturing of timing information,
-     * <code>&lt;record-message-sizes&gt;</code> enables capturing of sizing information.
-     * Set these parameters to <code>true</code> or <code>false</code>, 
-     * where the default value is <code>false</code>. 
-     * You can set them to different values to capture only one type of metrics. 
-     * For example, the following channel definition specifies to capture message timing information, 
-     * but not message sizing information:</p>
-     *
-     * <pre>
-     * &lt;channel-definition id="my-streaming-amf" 
-     *     class="mx.messaging.channels.StreamingAMFChannel"&gt;
-     *     &lt;endpoint 
-     *         url="http://{server.name}:{server.port}/{context.root}/messagebroker/streamingamf"          
-     *         class="flex.messaging.endpoints.StreamingAMFEndpoint"/&gt;
-     *     &lt;properties&gt;
-     *         &lt;record-message-times&gt;true&lt;/record-message-times&gt;
-     *         &lt;record-message-sizes&gt;false&lt;/record-message-sizes&gt;
-     *     &lt;/properties&gt;
-     * &lt;/channel-definition&gt;</pre>     
+     * Metrics are gathered when corresponding properties on the channel used are enabled:
+     * &lt;record-message-times&gt; denotes capturing of timing information,
+     * &lt;record-message-sizes&gt; denotes capturing of sizing information.
      * 
-     * <p>In your client application, you use the methods and properties of this class 
-     * to retrieve performance metrics about received messages.</p>
+     * <p>You can then use methods of this utility class to retrieve various performance information
+     * about the message that you have just received.</p>
      * 
      * <p>When these metrics are enabled an instance of this class should be created from 
-     * a response, acknowledgement, or message handler in the form: </p>
-     * 
-     * <pre>var mpiutil:MessagePerformanceUtils = new MessagePerformanceUtils(event.message);
+     * a response, acknowledgement, or message handler via something like: </p>
+     * @example
+     * <pre>
+     *      var mpiutil:MessagePerformanceUtils = new MessagePerformanceUtils(event.message);
      * </pre>    
      * 
-     *  
-     *  @langversion 3.0
-     *  @playerversion Flash 9
-     *  @playerversion AIR 1.1
-     *  @productversion BlazeDS 4
-     *  @productversion LCDS 3 
      */ 
     public class MessagePerformanceUtils
     {   

        }           
        
        /**
         * Time, in milliseconds, from when the server pushed the message 
         * until the client received it. 
         * Note that this value is only relevant if the server and receiving client 
         * have synchronized clocks.
         * Only populated in the case of a pushed message, but not for an acknowledge message.
         *  
         *  @langversion 3.0
         *  @playerversion Flash 9
         *  @playerversion AIR 1.1
         *  @productversion BlazeDS 4
         *  @productversion LCDS 3 
         */ 
        public function get pushOneWayTime():Number
        {

        }       
        
        /**
         * Timestamp in milliseconds since epoch of when the client received response message from
         * the server
         * 
         * @return Timestamp in milliseconds since epoch
         */         
        public function get clientReceiveTime():Number
        {
