Fix doc errors in xmlcpr.inc and fill in the missing doc headers

/**
 * Construct an object representing an XML-RPC message.
 *
 * @param $message
 *   String containing XML as defined at http://www.xmlrpc.com/spec
 *
 * @return
 *   Object
 */
function xmlrpc_message($message) {
  $xmlrpc_message = new stdClass();
  $xmlrpc_message->array_structs = array();   // The stack used to keep track of the current array/struct
  $xmlrpc_message->array_structs_types = array(); // The stack used to keep track of if things are structs or array
  $xmlrpc_message->current_struct_name = array();  // A stack as well
  $xmlrpc_message->message = $message;
  return $xmlrpc_message;
}

and

/**
 * Store a copy of the $xmlrpc_message object temporarily.
 *
 * @param $value.
 *   Object
 *
 * @return
 *   The most recently stored $xmlrpc_message.
 */
function xmlrpc_message_set($value = NULL) {
  static $xmlrpc_message;
  if ($value) {
    $xmlrpc_message = $value;
  }
  return $xmlrpc_message;
}

Are the code parts for the incomplete headers.

There are even some undocumented functions in that class...
So I'll leave this patch needs work for now and I'm changing the title.

Would be nice if the coder of that part could fix this.

Read through the docs with dreditor.
This is ready to go.

Jhodgdon++

Whoops, reading it again.

 Each response is the return value of the method, just as if it
+ *   has been a local function call, on success, or FALSE on failure

Must there be a "TRUE" before on success?

Ok, RTBC after all