X-Git-Url: http://git.kaliko.me/?a=blobdiff_plain;f=sid%2Flog.py;h=278be3d505ebbe63d7dbdfcbe108eec57b1dbf66;hb=aedd6aa01b9f279a4ae5b10b31b66900ce84c07b;hp=746fad2f08c2eedf5694da6dd80be68d1b3b18f8;hpb=55a4c77646865cd41014311e0efd86392ca4b5d5;p=sid.git

diff --git a/sid/log.py b/sid/log.py
index 746fad2..278be3d 100644
--- a/sid/log.py
+++ b/sid/log.py
@@ -23,7 +23,10 @@ from .plugin import Plugin, botcmd
 
 
 class Log(Plugin):
-    """Logs presence.
+    """Logs group chat participant presence.
+
+    The account running the bot need at least room moderation right to log
+    participants JIDs (fallback to nickname).
     """
     throttle_ts = int(time())-30
 
@@ -67,8 +70,9 @@ class Log(Plugin):
 
     @botcmd(hidden=True)
     def write(self, message, args):
-        """
-        **command** ``!write`` : Write log to file"""
+        """Dump/save room presences log
+
+        ``!write`` : Writes log to file (use mktemp and return file location as MUC message)"""
         delay = int(time()) - Log.throttle_ts
         if delay < 30:
             self.log.debug('throttling file creation')
@@ -86,7 +90,7 @@ class Log(Plugin):
 
     @botcmd(hidden=True)
     def dump(self, message, args):
-        """**command**  ``!dump``  : dump log online!"""
+        """``!dump``  : Dumps log as MUC message"""
         self.reply(message, self._format_log())