Limnoria/plugins/Ctcp/README.rst
Valentin Lorentz cd02444f87 supybot-plugin-doc: Add labels for all command and config variables
So they can be referenced from elsewhere in the doc.
2021-04-06 00:33:07 +02:00

45 lines
1.6 KiB
ReStructuredText

.. _plugin-Ctcp:
Documentation for the Ctcp plugin for Supybot
=============================================
Purpose
-------
Handles standard CTCP responses to PING, TIME, SOURCE, VERSION, USERINFO,
and FINGER.
Usage
-----
Provides replies to common CTCPs (version, time, etc.), and a command
to fetch version responses from channels.
Please note that the command `ctcp version` cannot receive any responses if the channel is
mode +C or similar which prevents CTCP requests to channel.
.. _commands-Ctcp:
Commands
--------
.. _command-Ctcp-version:
version [<channel>] [--nicks]
Sends a CTCP VERSION to <channel>, returning the various version strings returned. It waits for 10 seconds before returning the versions received at that point. If --nicks is given, nicks are associated with the version strings; otherwise, only the version strings are given.
Configuration
-------------
supybot.plugins.Ctcp.public
This config variable defaults to "True", is not network-specific, and is not channel-specific.
Determines whether this plugin is publicly visible.
supybot.plugins.Ctcp.userinfo
This config variable defaults to "", is not network-specific, and is not channel-specific.
Determines what will be sent when a USERINFO query is received.
supybot.plugins.Ctcp.versionWait
This config variable defaults to "10", is not network-specific, and is not channel-specific.
Determines how many seconds the bot will wait after getting a version command (not a CTCP VERSION, but an actual call of the command in this plugin named "version") before replying with the results it has collected.