summaryrefslogtreecommitdiff
path: root/plugins/ping.py
diff options
context:
space:
mode:
Diffstat (limited to 'plugins/ping.py')
-rw-r--r--plugins/ping.py32
1 files changed, 32 insertions, 0 deletions
diff --git a/plugins/ping.py b/plugins/ping.py
index faf3e97d..c4f56c81 100644
--- a/plugins/ping.py
+++ b/plugins/ping.py
@@ -1,3 +1,35 @@
+"""
+This plugin allows you to ping an entity.
+
+Installation
+------------
+You only have to load the plugin.
+
+.. code-block:: none
+
+ /load ping
+
+Command
+-------
+
+.. glossary::
+
+ /ping
+ **Usage (globally):** ``/ping <jid>``
+
+ **Usage (in a MUC tab):** ``/ping <jid or nick>``
+
+ **Usage (in a conversation tab):** ``/ping [jid]``
+
+ Globally, you can do ``/ping jid@example.com`` to get a ping.
+
+ In a MUC, you can either do it to a JID or a nick (``/ping nick`` or ``/ping
+ jid@example.com``).
+
+ In a private or a direct conversation, you can do ``/ping`` to ping
+ the current interlocutor.
+"""
+
from plugin import BasePlugin
from roster import roster
from common import safeJID