     }
 
     /**
-     * This method is used when you use the "send" method to the mx.rpc.http.Operation.
-     * That method takes an array of parameters without names.  The role of this method
-     * is to convert this to a single object which is used as the data for the HTTP request
-     * body.  The default implementation produces an object where the keys are the values
-     * in the Operation's argumentNames array and the values are the values of the parameters.
+     * This method is called from the "send" method of the HTTP service invocation to convert the
+     * parameters into a request body.  The parameters of the original send call are put into the
+     * params array.  This method converts this set of parameters into to a single object which is used as the 
+     * data for the HTTP request body.  The default implementation produces an object where the 
+     * keys are the values in the Operation's argumentNames array and the values are the values of the parameters.
      * When using the default implementation, you must set argumentNames to have the same number
      * of elements as the parameters array.
      * 
      * <p>Note that this method is not used if you invoke the HTTP operation using the sendBody
      * method which just takes a single object.  In that case, this step is skipped and only
      * the serializeBody method is called.</p>
+     *
+     * @param operation The AbstractOperation being invoked.
+     * @param params the list of parameters passed to the send method
+     * @return the body to be used in the HTTP request
      */
     public function serializeParameters(operation:AbstractOperation, params:Array):Object
     {


    /**
     * This method is used if you need to take data from the request body object and encode
     * it into the URL string.   It is given the incoming URL.  By default, the incoming
     * URL is returned directly.
     */
    public function serializeURL(operation:AbstractOperation, obj:Object, url:String):String
    {

    /**
     * This method is called for all invocations of the HTTP service.  It is able to convert
     * the supplied object into a form suitable for placing directly in the HTTP's request
     * body.  The default implementation just returns the object passed in as the body without
     * any conversion.
     *
     * @param operation The AbstractOperation being invoked
     * @param obj the initial body of the HTTP request, either the return value of serializeParameters or the parameter to the sendBody method
     * or the send method of HTTPService.
     * @return the potentially converted body to use in the request.
     */
    public function serializeBody(operation:AbstractOperation, obj:Object):Object
    {
