From: Magnus H. <leg...@us...> - 2008-02-20 13:24:33
|
Update of /cvsroot/emacs-jabber/emacs-jabber In directory sc8-pr-cvs17.sourceforge.net:/tmp/cvs-serv28887 Modified Files: jabber-iq.el Log Message: Revision: ma...@fr...--2005/emacs-jabber--cvs-head--0--patch-453 Creator: Magnus Henoch <ma...@fr...> Correct and clarify jabber-send-iq docstring Index: jabber-iq.el =================================================================== RCS file: /cvsroot/emacs-jabber/emacs-jabber/jabber-iq.el,v retrieving revision 1.22 retrieving revision 1.23 diff -u -d -r1.22 -r1.23 --- jabber-iq.el 17 Sep 2007 12:26:16 -0000 1.22 +++ jabber-iq.el 20 Feb 2008 13:24:11 -0000 1.23 @@ -1,6 +1,6 @@ ;; jabber-iq.el - infoquery functions -;; Copyright (C) 2003, 2004, 2007 - Magnus Henoch - ma...@fr... +;; Copyright (C) 2003, 2004, 2007, 2008 - Magnus Henoch - ma...@fr... ;; Copyright (C) 2002, 2003, 2004 - tom berger - ob...@in... ;; This file is a part of jabber.el. @@ -112,11 +112,15 @@ QUERY is a list containing the child of the iq node in the format `jabber-sexp2xml' accepts. SUCCESS-CALLBACK is the function to be called when a successful result arrives. -SUCCESS-CLOSURE-DATA is the second argument to SUCCESS-CALLBACK. +SUCCESS-CLOSURE-DATA is an extra argument to SUCCESS-CALLBACK. ERROR-CALLBACK is the function to be called when an error arrives. -ERROR-CLOSURE-DATA is the second argument to ERROR-CALLBACK. +ERROR-CLOSURE-DATA is an extra argument to ERROR-CALLBACK. RESULT-ID is the id to be used for a response to a received iq message. -`jabber-report-success' and `jabber-process-data' are common callbacks." +`jabber-report-success' and `jabber-process-data' are common callbacks. + +The callback functions are called like this: +\(funcall CALLBACK JC XML-DATA CLOSURE-DATA) +with XML-DATA being the IQ stanza received in response. " (let ((id (or result-id (apply 'format "emacs-iq-%d.%d.%d" (current-time))))) (if (or success-callback error-callback) (setq *jabber-open-info-queries* (cons (list id |