From 54fdda5019b97d3d0473bbcae822d44f2bb1352c Mon Sep 17 00:00:00 2001 From: defanor Date: Sun, 26 Sep 2021 19:31:17 +0300 Subject: Add emacs/README --- emacs/README | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 emacs/README diff --git a/emacs/README b/emacs/README new file mode 100644 index 0000000..e50d9cc --- /dev/null +++ b/emacs/README @@ -0,0 +1,25 @@ +xmpp.el - an Emacs interface to rexmpp + +Since Emacs can't poll sockets and use rexmpp directly, this works by +introducing a program which basically serializes library calls and +callbacks into XML, and which xmpp.el runs as a subprocess. + +Once rexmpp_xml_interface is built, and possibly the path to it is +adjusted in the xmpp-command variable, one can load xmpp.el, set a +password in ~/.authinfo (or elsewhere auth-source will be able to read +it from, with "port xmpp"), perhaps enable tracking-mode, and run M-x +xmpp RET RET. + +The buffers it creates are an XML console, a text console (using +rexmpp's console module, type "help" to see the available commands), a +process buffer, a log buffer. The xmpp-query function (or just +incoming messages) will create query buffers for one-to-one chats, +xmpp-muc-join creates MUC ones. + +The used XML interface will probably be changed to allow asynchronous +requests in both ways, and there's still a lot to add or improve in +xmpp.el, but it is fairly usable (i.e., replaces bitlbee + rcirc for +me) since September 2021. + +Possibly in the future it will work with other libraries as well, +and/or will be moved out of the rexmpp's repository. -- cgit v1.2.3