--- a/src/core/xmpp.py	Sat Jun 06 17:01:22 2015 +0200
+++ b/src/core/xmpp.py	Wed Jun 10 09:18:34 2015 +0200
@@ -354,6 +354,13 @@
         self.host.bridge.presenceUpdate(entity.full(), "unavailable", 0, statuses, self.parent.profile)
 
     def available(self, entity=None, show=None, statuses=None, priority=None):
+        """Set a presence and statuses.
+
+        @param entity (jid.JID): entity
+        @param show (unicode): value in ('unavailable', '', 'away', 'xa', 'chat', 'dnd')
+        @param statuses (dict{unicode: unicode}): multilingual statuses with
+            the entry key beeing a language code on 2 characters or "default".
+        """
         if priority is None:
             try:
                 priority = int(self.host.memory.getParamA("Priority", "Connection", profile_key=self.parent.profile))