Changes between Initial Version and Version 1 of Jabber

Timestamp:

Jan 17, 2010, 8:39:06 PM (14 years ago)

Author:

afarrell@mit.edu

Comment:

--

Jabber

@@ +1 @@
+'''Jabber commands in barnowl'''
+
+A JID is a "Jabber Identification", which could be an individual user or a multi-user chat (MUC).
+
+'''jabberlogin'''
+
+ jabberlogin JID [password]
+
+If you're running barnowl on athena and want to log in to the mit.edu jabber server, you can probably just use the following command:
+
+ :jabberlogin username@mit.edu
+
+and your kerberos tickets will get passed along to the jabber server so that you don't have to enter your password.
+
+
+'''jwrite'''<br />
+
+ jwrite JID [-t thread] [-s subject]
+
+Pressing j in barnowl will fill in the jwrite command for you, so typically, you'll jwrite to a JID by typing 
+
+j username@mit.edu
+
+or 
+
+j chatroom@conference.mit.edu
+
+Replying to jabber messages in barnowl is easily done by pressing r, which will start a jwrite command with the appropriate JID, whether for a user or a MUC.
+
+'''jmuc'''<br />
+
+ jmuc COMMAND ARGS
+
+jmuc commands: join, part, invite, configure, presence, presence -a
+
+jmuc is the command for dealing with MUCs in barnowl. You might use
+
+ :jmuc join <muc>
+
+to join a MUC.
+                               
+ :jmuc part <muc>
+
+to part (leave, stop getting messages from) a MUC. The MUC is taken from the current message if not supplied.
+ 
+ :jmuc invite <jid> <muc>
+
+to invite that JID to that MUC. The MUC is taken from the current message if not supplied.
+
+ :jmuc configure <muc>
+
+to configure a MUC, which is necessary when setting up a new MUC; only the default configuration works for now, and the MUC is taken from the current message if it's not supplied in the command.
+
+ :jmuc presence <muc>
+
+to see the roster of JIDs in the MUC
+
+ :jmuc presence -a
+
+to see the rosters of JIDs for all the MUCs you're in at the time.
+
+
+'''jroster'''<br />
+
+jroster COMMAND ARGS
+
+jroster is the command for dealing with your Jabber roster. Dealing with a Jabber roster lets you get notifications from Jabber servers about whether users are logged in, or when users log in or out, among other things.
+
+jroster commands: sub add unsub remove auth deauth
+
+ :jroster sub JID
+
+will ask that JID if you can subscribe to their presence. Unlike on zephyr, you allow users to know about whether you're logged in or not on a per-user basis, and they do the same for you.
+
+ :jroster add JID
+
+will add that JID to your roster without attempting to subscribe to their presence. This can be useful in the case of adding a shortname for a JID to your roster; see below for more information on that.
+
+ :jroster remove JID
+
+will unsubscibe you from presence information about that JID, and remove that JID from your roster
+
+ :jroster unsub JID
+
+will just unsubscribe from presence information about that JID.
+
+ :jroster auth JID
+
+and 
+
+ :jroster deauth JID
+
+respectively authorize and deauthorize that JID to get presence information about you. If you get an OWL ADMIN message saying "Allow user (username@mit.edu) to subscribe to your presence? (Answer with the `yes' or `no' commands)", then, with the pointer on the message, you can use 
+
+ :yes 
+
+to authorize that JID as if you'd typed
+
+ :jroster auth username@mit.edu
+
+and similarly, 
+
+ :no 
+
+to deny that JID information about your presence.
+
+jroster argument flags: -g, -p, -n, and -a
+
+-g, -p, and -n work with only the add and sub commands
+
+-g is for adding a JID or JIDs to a group:
+
+ :jroster add JID [additional JIDs separated by spaces] -g group
+
+
+-p is for purging a JID or JIDs from all groups:
+
+ :jroster add JID [additional JIDs separated by spaces] -p
+
+-n is for associating a JID with a short name:
+
+ :jroster add JID -n shortname
+
+the -n flag only works with one JID at a time.
+
+-a is for specifying which Jabber account the jroster command is for, in case you're logged into multiple Jabber accounts. The -a flag works with any of the jroster commands.
+
+ :jroster COMMAND JID1 -a JID2
+
+Would be what you would do when you want to add JID1 to the roster of your Jabber account JID2