diff --git a/documentation/gettingstarted.html b/documentation/gettingstarted.html index 2997af5e4..04069aef3 100644 --- a/documentation/gettingstarted.html +++ b/documentation/gettingstarted.html @@ -59,10 +59,13 @@ new Chat or GroupChat objects.

Working with the Roster

+The roster lets you keep track of the availability (presence) of other users. Users +can be organized into groups such as "Friends" and "Co-workers", and then you +discover whether each user is online or offline.

-Retrieve a roster using the XMPPConnection.getRoster() method. The roster +Retrieve the roster using the XMPPConnection.getRoster() method. The roster class allows you to find all the roster entries, the groups they belong to, and the -current presence status each entry. +current presence status of each entry.

Reading and Writing Packets @@ -70,12 +73,12 @@ Reading and Writing Packets Each message to the XMPP server from a client is called a packet and is sent as XML. The org.jivesoftware.smack.packet package contains -classes that encapsulate the different packet types allowed by XMPP (message, -presence, and IQ). Classes such as Chat and GroupChat +classes that encapsulate the three different basic packet types allowed by +XMPP (message, presence, and IQ). Classes such as Chat and GroupChat provide higher-level constructs that manage creating and sending packets automatically, but you can also create and send packets directly. Below -is a code example for changing our presence to let people know we're unavailable -because we're "out fishing":

+is a code example for changing your presence to let people know you're unavailable +and "out fishing":

@@ -94,8 +97,8 @@ while a packet collector has a result queue of packets that you can do
 polling and blocking operations on. So, a packet listener is useful when
 you want to take some action whenever a packet happens to come in, while a
 packet collector is useful when you want to wait for a specific packet
-to come through. Packet collectors and listeners can be created using the
-connection object.
+to arrive. Packet collectors and listeners can be created using an
+XMPPConnection instance.