bugEmacs Weblogging - Bugs: bug #27738, Misleading description of...

 
 

bug #27738: Misleading description of xml-rpc-method-call-async

Submitter:  None
Submitted:  Sat 17 Oct 2009 04:33:24 PM UTC
   
 
Category:  xmlrpc.el Severity:  3 - Normal
Item Group:  None Status:  None
Privacy:  Public Assigned to:  None
Open/Closed:  Open
* Mandatory Fields

Add a New Comment Rich Markup
   

Sat 17 Oct 2009 04:33:24 PM UTC, original submission:  

Hello,

While experimenting with xml-rpc.el I noticed that (at least to me) the description of `xml-rpc-method-call-async' in xml-rpc.el is misleading. It states:

,----
| Call an XML-RPC method asynchronously at SERVER-URL named METHOD with
| PARAMS as parameters. When the method returns, ASYNC-CALLBACK-FUNC
| will be called with the result as parameter.
`----

The misleading term is 'with the result as parameter'. What I expected to get as parameter for my ASNC-CALLBACK-FUNC is a result list like I do get when doing a sync xmlrpc call. But I noticed that the callback function gets http responses (if any) and operates on a buffer that has to be parsed with `xml-rpc-request-process-buffer' and `xml-rpc-xml-to-response'.

What strenghtend the wrong assumption about `xml-rpc-method-call-async' was the example for a callback function given in the commentary section:

,----
| (defun cb-foo (foo)
|   (print (format "%s" foo)))
`----

As FOO won't be a string at all but nil or a list of http responsens.

Regards,
  -- David

Anonymous

 

(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

Attach Files:
   
   
Comment:
   

No files currently attached

 

Depends on the following items: None found

Items that depend on this one: None found

 

CC list is empty

 

There are 0 votes so far. Votes easily highlight which items people would like to see resolved in priority, independently of the priority of the item set by tracker managers.

Only logged-in users can vote.

 

No changes have been made to this item

Back to the top

Powered by Savane 3.13-f8d8.
Corresponding source code