diff doc/jp/info.rst @ 3041:72583524cfd3

doc (jp): jp commands are now fully documented: rel 232
author Goffi <goffi@goffi.org>
date Tue, 01 Oct 2019 22:49:06 +0200
parents
children f6f716d90ce4
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/jp/info.rst	Tue Oct 01 22:49:06 2019 +0200
@@ -0,0 +1,58 @@
+
+==================================
+info: retrieve various information
+==================================
+
+``info`` groups subcommands used to retrieve read-only informations.
+
+disco
+=====
+
+Display discovery information (see `XEP-0030`_ for details). This can be used to check
+which features you server or a service is offering, and which items are available (items
+can be services like chat room, gateways, etc).
+
+You only have to specify the jid of the entity to check, and optionally a node.
+
+By default both infos and items are requested, but you can restrict what to request by
+using ``-t {infos,items,both}, --type {infos,items,both}``
+
+.. _XEP-0030: https://xmpp.org/extensions/xep-0030.html
+
+
+example
+-------
+
+Request infos and items from a server::
+
+  $ jp info disco example.org
+
+version
+=======
+
+Request software version of an entity. You only need to specify the jid of the entity as
+positional argument.
+
+Depending of the software and its configuration, you have software version, software name,
+and the operating system on which the software is running.
+
+example
+-------
+
+Check version of a server::
+
+  $ jp info version example.org
+
+session
+-------
+
+Give information about the session of the given profile. You'll the full jid currently
+used on the server, and the time when the session was started (which may not be the same
+time as when the connection with the XMPP server was started).
+
+example
+-------
+
+Get session informations::
+
+  $ jp info session