supybot-plugin-doc: Add missing newlines + regenerate all READMEs.

This commit is contained in:
Valentin Lorentz 2021-12-04 02:50:28 +01:00
parent ef0cd48bd1
commit 828fff9cc0
70 changed files with 216 additions and 7 deletions

View File

@ -5,11 +5,13 @@ Documentation for the Admin plugin for Supybot
Purpose
-------
These are commands useful for administrating the bot; they all require their
caller to have the 'admin' capability. This plugin is loaded by default.
Usage
-----
This plugin provides access to administrative commands, such as
adding capabilities, managing ignore lists, and joining channels.
This is a core Supybot plugin that should not be removed!
@ -18,6 +20,7 @@ This is a core Supybot plugin that should not be removed!
Commands
--------
.. _command-admin-acmd:
acmd <command> [<arg> ...]

View File

@ -5,12 +5,14 @@ Documentation for the Aka plugin for Supybot
Purpose
-------
This plugin allows the user to create various aliases (known as "Akas", since
Alias is the name of another plugin Aka is based on) to other commands or
combinations of other commands (via nested commands).
Usage
-----
This plugin allows users to define aliases to commands and combinations
of commands (via nesting).
@ -76,6 +78,7 @@ reply with the same information, the result of those commands.
Commands
--------
.. _command-aka-add:
add [--channel <#channel>] <name> <command>

View File

@ -5,11 +5,13 @@ Documentation for the Alias plugin for Supybot
Purpose
-------
Allows aliases for other commands. NOTE THAT IT'S RECOMMENDED TO USE Aka
PLUGIN INSTEAD!
Usage
-----
This plugin allows users to define aliases to commands and combinations
of commands (via nesting).
This plugin is only kept for backward compatibility, you should use the
@ -36,6 +38,7 @@ reply with the same information, the result of those commands.
Commands
--------
.. _command-alias-add:
add <name> <command>

View File

@ -5,10 +5,12 @@ Documentation for the Anonymous plugin for Supybot
Purpose
-------
Allows folks to talk through the bot anonymously.
Usage
-----
This plugin allows users to act through the bot anonymously. The 'do'
command has the bot perform an anonymous action in a given channel, and
the 'say' command allows other people to speak through the bot. Since
@ -48,6 +50,7 @@ This
Commands
--------
.. _command-anonymous-do:
do <channel> <action>

View File

@ -5,12 +5,14 @@ Documentation for the AutoMode plugin for Supybot
Purpose
-------
Automatically ops, voices, or halfops, or bans people when they join a channel,
according to their capabilities. If you want your bot automatically op users
when they join your channel, this is the plugin to load.
Usage
-----
This plugin, when configured, allows the bot to automatically set modes
on users when they join.

View File

@ -5,6 +5,7 @@ Documentation for the Autocomplete plugin for Supybot
Purpose
-------
Autocomplete: Provides command autocompletion for IRC clients that support it.
This plugin implements an early draft of the IRCv3 autocompletion client tags.
@ -17,6 +18,7 @@ If you are interested in this feature, please contribute to
Usage
-----
Provides command completion for IRC clients that support it.
.. _conf-Autocomplete:

View File

@ -5,6 +5,7 @@ Documentation for the BadWords plugin for Supybot
Purpose
-------
Filters bad words on outgoing messages from the bot, so the bot can't be made
to say bad words.
As an additional capability, it can (optionally) kick users who
@ -12,6 +13,7 @@ use such words from channels that have that capability enabled.
Usage
-----
Maintains a list of words that the bot is not allowed to say.
Can also be used to kick people that say these words, if the bot
has op.
@ -20,6 +22,7 @@ has op.
Commands
--------
.. _command-badwords-add:
add <word> [<word> ...]

View File

@ -5,11 +5,13 @@ Documentation for the Channel plugin for Supybot
Purpose
-------
Basic channel management commands. Many of these commands require their caller
to have the #channel,op capability. This plugin is loaded by default.
Usage
-----
This plugin provides various commands for channel management, such
as setting modes and channel-wide bans/ignores/capabilities. This is
a core Supybot plugin that should not be removed!
@ -18,6 +20,7 @@ a core Supybot plugin that should not be removed!
Commands
--------
.. _command-channel-alert:
alert [<channel>] <text>

View File

@ -5,10 +5,12 @@ Documentation for the ChannelLogger plugin for Supybot
Purpose
-------
Logs each channel to its own individual logfile.
Usage
-----
This plugin allows the bot to log channel conversations to disk.
.. _conf-ChannelLogger:
@ -112,13 +114,21 @@ supybot.plugins.ChannelLogger.rotateLogs
Determines whether the bot will automatically rotate the logs for this channel. The bot will rotate logs when the timestamp for the log changes. The timestamp is set according to the 'filenameTimestamp' configuration variable.
.. _conf-supybot.plugins.ChannelLogger.showAway:
supybot.plugins.ChannelLogger.showAway
This config variable defaults to "True", is network-specific, and is channel-specific.
Determines whether users going away and coming back should be logged. This is only supported on networks implementing the 'away-notify' IRCv3 capability.
.. _conf-supybot.plugins.ChannelLogger.showJoinParts:
supybot.plugins.ChannelLogger.showJoinParts
This config variable defaults to "True", is network-specific, and is channel-specific.
Determines wether joins and parts are logged
Determines whether joins and parts are logged
.. _conf-supybot.plugins.ChannelLogger.stripFormatting:

View File

@ -5,12 +5,14 @@ Documentation for the ChannelStats plugin for Supybot
Purpose
-------
Silently listens to every message received on a channel and keeps statistics
concerning joins, parts, and various other commands in addition to tracking
statistics about smileys, actions, characters, and words.
Usage
-----
This plugin keeps stats of the channel and returns them with
the command 'channelstats'.
@ -18,6 +20,7 @@ the command 'channelstats'.
Commands
--------
.. _command-channelstats-channelstats:
channelstats [<channel>]

View File

@ -5,6 +5,7 @@ Documentation for the Conditional plugin for Supybot
Purpose
-------
Contains numerous conditional commands (such as 'if', 'and', and 'or'),
which can be used on their own or with another plugin.
Also provides logic operators for writing conditions.
@ -13,6 +14,7 @@ Useful for bot scripting / nested commands.
Usage
-----
This plugin provides logic operators and other commands that
enable you to run commands only if a condition is true. Useful for nested
commands and scripting.
@ -21,6 +23,7 @@ commands and scripting.
Commands
--------
.. _command-conditional-cand:
cand <cond1> [<cond2> ... <condN>]

View File

@ -5,10 +5,12 @@ Documentation for the Config plugin for Supybot
Purpose
-------
Handles configuration of the bot while it is running.
Usage
-----
Provides access to the Supybot configuration. This is
a core Supybot plugin that should not be removed!
@ -16,6 +18,7 @@ a core Supybot plugin that should not be removed!
Commands
--------
.. _command-config-channel:
channel [<network>] [<channel>] <name> [<value>]

View File

@ -5,11 +5,13 @@ 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.
@ -20,6 +22,7 @@ mode +C or similar which prevents CTCP requests to channel.
Commands
--------
.. _command-ctcp-version:
version [<channel>] [--nicks]

View File

@ -5,10 +5,12 @@ Documentation for the DDG plugin for Supybot
Purpose
-------
Searches for results on DuckDuckGo's web search.
Usage
-----
Searches for results on DuckDuckGo.
Example::
@ -20,6 +22,7 @@ Example::
Commands
--------
.. _command-ddg-search:
search <text>

View File

@ -5,12 +5,14 @@ Documentation for the Debug plugin for Supybot
Purpose
-------
This is for developers debugging their plugins; it provides an eval command
as well as some other useful commands.
It should not be loaded with a default installation.
Usage
-----
This plugin provides debugging abilities for Supybot. It
should not be loaded with a default installation.
@ -18,6 +20,7 @@ should not be loaded with a default installation.
Commands
--------
.. _command-debug-channeldb:
channeldb [<channel>]

View File

@ -5,6 +5,7 @@ Documentation for the Dict plugin for Supybot
Purpose
-------
Commands that use the dictd protocol to define words.
In order to use this plugin you must have the following modules
@ -14,6 +15,7 @@ installed:
Usage
-----
This plugin provides a function to look up words from different
dictionaries.
@ -21,6 +23,7 @@ dictionaries.
Commands
--------
.. _command-dict-dict:
dict [<dictionary>] <word>

View File

@ -5,6 +5,7 @@ Documentation for the Dunno plugin for Supybot
Purpose
-------
The Dunno module is used to spice up the reply when given an invalid command
with random 'I dunno'-like responses. If you want something spicier than
'<x> is not a valid command'-like responses, use this plugin.
@ -12,6 +13,7 @@ Like Success does for the 'The operation succeeded.' reply.
Usage
-----
This plugin was written initially to work with MoobotFactoids, the two
of them to provide a similar-to-moobot-and-blootbot interface for factoids.
Basically, it replaces the standard 'Error: <x> is not a valid command.'
@ -24,6 +26,7 @@ responses.
Commands
--------
.. _command-dunno-add:
add [<channel>] <text>

View File

@ -5,17 +5,20 @@ Documentation for the Factoids plugin for Supybot
Purpose
-------
Handles 'factoids,' little tidbits of information held in a database and
available on demand via several commands.
Usage
-----
Provides the ability to show Factoids.
.. _commands-Factoids:
Commands
--------
.. _command-factoids-alias:
alias [<channel>] <oldkey> <newkey> [<number>]

View File

@ -5,10 +5,12 @@ Documentation for the Fediverse plugin for Supybot
Purpose
-------
Fetches information from ActivityPub servers.
Usage
-----
Fetches information from ActivityPub servers.
Enabling Secure Fetch
@ -37,6 +39,7 @@ a title like "Supybot web server index").
Commands
--------
.. _command-fediverse-featured:
featured <@user@instance>

View File

@ -5,6 +5,7 @@ Documentation for the Filter plugin for Supybot
Purpose
-------
Provides numerous filters, and a command (outfilter) to set them as filters on
the output of the bot.
For instance, you could make everything the bot says be
@ -16,6 +17,7 @@ commands.
Usage
-----
This plugin offers several commands which transform text in some way.
It also provides the capability of using such commands to 'filter' the
output of the bot -- for instance, you could make everything the bot says
@ -26,6 +28,7 @@ Not very useful, but definitely quite fun :)
Commands
--------
.. _command-filter-aol:
aol <text>

View File

@ -5,6 +5,7 @@ Documentation for the Format plugin for Supybot
Purpose
-------
Provides simple commands for formatting text on IRC (like bold),
and to change the output of the bot for a particular command.
See also the :ref:`Filter plugin <plugin-Filter>` to configure
@ -12,6 +13,7 @@ the output format for all commands.
Usage
-----
Provides some commands for formatting text, such as making text bold or
capitalized.
@ -19,6 +21,7 @@ capitalized.
Commands
--------
.. _command-format-bold:
bold <text>

View File

@ -5,16 +5,19 @@ Documentation for the GPG plugin for Supybot
Purpose
-------
GPG: Provides authentication based on GPG keys.
Usage
-----
Provides authentication based on GPG keys.
.. _commands-GPG:
Commands
--------
.. _command-gpg-key.add:
key add <key id> <key server>

View File

@ -5,12 +5,14 @@ Documentation for the Games plugin for Supybot
Purpose
-------
This plugin provides some fun games like (Russian) roulette, 8ball, monologue
which tells you how many lines you have spoken without anyone interrupting
you, coin and dice.
Usage
-----
This plugin provides some small games like (Russian) roulette,
eightball, monologue, coin and dice.
@ -18,6 +20,7 @@ eightball, monologue, coin and dice.
Commands
--------
.. _command-games-coin:
coin takes no arguments

View File

@ -5,10 +5,12 @@ Documentation for the Google plugin for Supybot
Purpose
-------
Accesses Google for various things.
Usage
-----
This is a simple plugin to provide access to the Google services we
all know and love from our favorite IRC bot.
@ -40,6 +42,7 @@ Check: `Supported language codes`_
Commands
--------
.. _command-google-cache:
cache <url>

View File

@ -5,16 +5,19 @@ Documentation for the Hashes plugin for Supybot
Purpose
-------
Provides various hash- and encryption-related commands.
Usage
-----
Provides hash or encryption related commands
.. _commands-Hashes:
Commands
--------
.. _command-hashes-algorithms:
algorithms <takes no arguments>

View File

@ -5,11 +5,13 @@ Documentation for the Herald plugin for Supybot
Purpose
-------
Greets users who join the channel with a recognized hostmask with a nice
little greeting.
Usage
-----
This plugin allows you to set welcome messages (heralds) to people who
are recognized by the bot when they join a channel.
@ -17,6 +19,7 @@ are recognized by the bot when they join a channel.
Commands
--------
.. _command-herald-add:
add [<channel>] <user|nick> <msg>

View File

@ -5,11 +5,13 @@ Documentation for the Internet plugin for Supybot
Purpose
-------
This plugin provides commands to transform domains into IP addresses and IP addresses to domains.
It can also search WHOIS information and return hexips.
Usage
-----
Provides commands to query DNS, search WHOIS databases,
and convert IPs to hex.
@ -17,6 +19,7 @@ and convert IPs to hex.
Commands
--------
.. _command-internet-dns:
dns <host|ip>

View File

@ -5,10 +5,12 @@ Documentation for the Karma plugin for Supybot
Purpose
-------
Plugin for keeping track of Karma for users and things in a channel.
Usage
-----
Provides a simple tracker for setting Karma (thing++, thing--).
If ``config plugins.karma.allowUnaddressedKarma`` is set to ``True``
(default since 2014.05.07), saying `boats++` will give 1 karma
@ -28,6 +30,7 @@ you must address the bot with nick or prefix to add or subtract karma.
Commands
--------
.. _command-karma-clear:
clear [<channel>] [<name>]

View File

@ -5,11 +5,13 @@ Documentation for the Lart plugin for Supybot
Purpose
-------
This plugin keeps a database of larts (Luser Attitude Readjustment Tool),
and larts with it.
Usage
-----
Provides an implementation of the Luser Attitude Readjustment Tool
for users.
@ -23,6 +25,7 @@ Example:
Commands
--------
.. _command-lart-add:
add [<channel>] <text>

View File

@ -5,12 +5,14 @@ Documentation for the Later plugin for Supybot
Purpose
-------
Informal notes, mostly for compatibility with other bots. Based entirely on
nicks, it's an easy way to tell users who refuse to register notes when they
arrive later.
Usage
-----
Used to do things later; currently, it only allows the sending of
nick-based notes. Do note (haha!) that these notes are *not* private
and don't even pretend to be; if you want such features, consider using the
@ -43,6 +45,7 @@ and the owner.
Commands
--------
.. _command-later-notes:
notes [<nick>]

View File

@ -5,12 +5,14 @@ Documentation for the Limiter plugin for Supybot
Purpose
-------
This plugin sets channel limits (MODE +l) based on
``plugins.Limiter.MaximumExcess`` plus the current number of users
in the channel. This is useful to prevent flood attacks.
Usage
-----
In order to use this plugin, its config values need to be properly
setup. supybot.plugins.Limiter.enable needs to be set to True and
supybot.plugins.Limiter.{maximumExcess,minimumExcess} should be set to

View File

@ -5,6 +5,7 @@ Documentation for the LogToIrc plugin for Supybot
Purpose
-------
Allows for sending the bot's logging output to channels or users.
.. _conf-LogToIrc:

View File

@ -5,11 +5,13 @@ Documentation for the Math plugin for Supybot
Purpose
-------
This plugin provides a calculator, converter, a list of units
and other useful math functions.
Usage
-----
Provides commands to work with math, such as a calculator and
a unit converter.
@ -17,6 +19,7 @@ a unit converter.
Commands
--------
.. _command-math-base:
base <fromBase> [<toBase>] <number>

View File

@ -5,6 +5,7 @@ Documentation for the MessageParser plugin for Supybot
Purpose
-------
The MessageParser plugin allows you to set custom regexp triggers,
which will trigger the bot to respond if they match anywhere in the message.
This is useful for those cases when you want a bot response even when the bot
@ -15,6 +16,7 @@ https://sourceforge.net/p/gribble/wiki/MessageParser_Plugin/
Usage
-----
This plugin can set regexp triggers to activate the bot.
Use 'add' command to add regexp trigger, 'remove' to remove.
@ -22,6 +24,7 @@ Use 'add' command to add regexp trigger, 'remove' to remove.
Commands
--------
.. _command-messageparser-add:
add [<channel>|global] <regexp> <action>

View File

@ -5,10 +5,12 @@ Documentation for the Misc plugin for Supybot
Purpose
-------
Miscellaneous commands.
Usage
-----
Miscellaneous commands to access Supybot core. This is a core
Supybot plugin that should not be removed!
@ -16,6 +18,7 @@ Supybot plugin that should not be removed!
Commands
--------
.. _command-misc-apropos:
apropos <string>

View File

@ -5,12 +5,14 @@ Documentation for the MoobotFactoids plugin for Supybot
Purpose
-------
Moobot factoid compatibility module. Moobot's factoids were originally
designed to emulate Blootbot's factoids, so in either case, you should find
this plugin comfortable.
Usage
-----
An alternative to the Factoids plugin, this plugin keeps factoids in
your bot.
@ -29,6 +31,7 @@ If you want the bot to use /mes with Factoids, that is possible too.
Commands
--------
.. _command-moobotfactoids-factinfo:
factinfo [<channel>] <factoid key>

View File

@ -5,12 +5,14 @@ Documentation for the Network plugin for Supybot
Purpose
-------
Includes commands for connecting, disconnecting, and reconnecting to multiple
networks, as well as several other utility functions related to IRC networks
like showing the latency.
Usage
-----
Provides network-related commands, such as connecting to multiple networks
and checking latency to the server.
@ -18,6 +20,7 @@ and checking latency to the server.
Commands
--------
.. _command-network-capabilities:
capabilities [<network>]

View File

@ -5,18 +5,21 @@ Documentation for the News plugin for Supybot
Purpose
-------
A module to allow each channel to have "news". News items may have expiration
dates.
It was partially inspired by the news system used on #debian's bot.
Usage
-----
This plugin provides a means of maintaining News for a channel.
.. _commands-News:
Commands
--------
.. _command-news-add:
add [<channel>] <expires> <subject>: <text>

View File

@ -5,10 +5,12 @@ Documentation for the NickAuth plugin for Supybot
Purpose
-------
Support authentication based on nicks and network services.
Usage
-----
This plugin allows users to use their network services account to
authenticate to the bot.
@ -20,6 +22,7 @@ identify to the bot.
Commands
--------
.. _command-nickauth-auth:
auth takes no argument

View File

@ -5,11 +5,13 @@ Documentation for the NickCapture plugin for Supybot
Purpose
-------
This module attempts to capture the bot's nick, watching for an opportunity to
switch to that nick.
Usage
-----
This plugin constantly tries to take whatever nick is configured as
supybot.nick. Just make sure that's set appropriately, and thus plugin
will do the rest.

View File

@ -5,18 +5,21 @@ Documentation for the Nickometer plugin for Supybot
Purpose
-------
A port of Infobot's nickometer command from Perl. This plugin
provides one command (called nickometer) which will tell you how 'lame'
an IRC nick is. It's an elitist hacker thing, but quite fun.
Usage
-----
Will tell you how lame a nick is by the command 'nickometer [nick]'.
.. _commands-Nickometer:
Commands
--------
.. _command-nickometer-nickometer:
nickometer [<nick>]

View File

@ -5,17 +5,20 @@ Documentation for the Note plugin for Supybot
Purpose
-------
A complete messaging system that allows users to leave 'notes' for other
users that can be retrieved later.
Usage
-----
Allows you to send notes to other users.
.. _commands-Note:
Commands
--------
.. _command-note-list:
list [--{old,sent}] [--{from,to} <user>]

View File

@ -5,11 +5,13 @@ Documentation for the Owner plugin for Supybot
Purpose
-------
Provides commands useful to the owner of the bot; the commands here require
their caller to have the 'owner' capability. This plugin is loaded by default.
Usage
-----
Owner-only commands for core Supybot. This is a core Supybot module
that should not be removed!
@ -17,6 +19,7 @@ that should not be removed!
Commands
--------
.. _command-owner-announce:
announce <text>

View File

@ -5,11 +5,13 @@ Documentation for the Plugin plugin for Supybot
Purpose
-------
This plugin handles various plugin-related things, such as getting help for
a plugin or retrieving author info.
Usage
-----
This plugin exists to help users manage their plugins. Use 'plugin
list' to list the loaded plugins; use 'plugin help' to get the description
of a plugin; use the 'plugin' command itself to determine what plugin a
@ -19,6 +21,7 @@ command exists in.
Commands
--------
.. _command-plugin-author:
author <plugin>

View File

@ -5,11 +5,13 @@ Documentation for the PluginDownloader plugin for Supybot
Purpose
-------
This plugin allows you to quickly download and install a plugin from other
repositories.
Usage
-----
This plugin allows you to install unofficial plugins from
multiple repositories easily. Use the "repolist" command to see list of
available repositories and "repolist <repository>" to list plugins,
@ -37,14 +39,14 @@ Examples
< Mikaela> @load PluginDownloader
< Limnoria> Ok.
< Mikaela> @plugindownloader repolist
< Limnoria> Antibody, jlu5, Hoaas, Iota, ProgVal, SpiderDave, boombot, code4lib, code4lib-edsu, code4lib-snapshot, doorbot, frumious, jonimoose, mailed-notifier, mtughan-weather, nanotube-bitcoin, nyuszika7h, nyuszika7h-old, pingdom, quantumlemur, resistivecorpse, scrum, skgsergio, stepnem
< Mikaela> @plugindownloader repolist ProgVal
< Limnoria> Antibody, jlu5, Hoaas, Iota, progval, SpiderDave, boombot, code4lib, code4lib-edsu, code4lib-snapshot, doorbot, frumious, jonimoose, mailed-notifier, mtughan-weather, nanotube-bitcoin, nyuszika7h, nyuszika7h-old, pingdom, quantumlemur, resistivecorpse, scrum, skgsergio, stepnem
< Mikaela> @plugindownloader repolist progval
< Limnoria> AttackProtector, AutoTrans, Biography, Brainfuck, ChannelStatus, Cleverbot, Coffee, Coinpan, Debian, ERepublik, Eureka, Fortune, GUI, GitHub, Glob2Chan, GoodFrench, I18nPlaceholder, IMDb, IgnoreNonVoice, Iwant, Kickme, LimnoriaChan, LinkRelay, ListEmpty, Listener, Markovgen, MegaHAL, MilleBornes, NoLatin1, NoisyKarma, OEIS, PPP, PingTime, Pinglist, RateLimit, Rbls, Redmine, Scheme, Seeks, (1 more message)
< Mikaela> more
< Limnoria> SilencePlugin, StdoutCapture, Sudo, SupyML, SupySandbox, TWSS, Trigger, Trivia, Twitter, TwitterStream, Untiny, Variables, WebDoc, WebLogs, WebStats, Website, WikiTrans, Wikipedia, WunderWeather
< Mikaela> @plugindownloader info ProgVal Wikipedia
< Mikaela> @plugindownloader info progval Wikipedia
< Limnoria> Grabs data from Wikipedia.
< Mikaela> @plugindownloader install ProgVal Wikipedia
< Mikaela> @plugindownloader install progval Wikipedia
< Limnoria> Ok.
< Mikaela> @load Wikipedia
< Limnoria> Ok.
@ -53,6 +55,7 @@ Examples
Commands
--------
.. _command-plugindownloader-info:
info <repository> <plugin>

View File

@ -5,10 +5,12 @@ Documentation for the Poll plugin for Supybot
Purpose
-------
Poll: Provides a simple way to vote on answers to a question
Usage
-----
Provides a simple way to vote on answers to a question
For example, this creates a poll::
@ -48,6 +50,7 @@ make it easier::
Commands
--------
.. _command-poll-add:
add [<channel>] <question> <answer1> [<answer2> [<answer3> [...]]]

View File

@ -5,10 +5,12 @@ Documentation for the Praise plugin for Supybot
Purpose
-------
Hand out praise to IRC denizens with this plugin.
Usage
-----
Praise is a plugin for ... well, praising things. Feel free to add
your own flavor to it by customizing what praises it gives. Use "praise
add <text>" to add new ones, making sure to include "$who" in <text> where
@ -24,6 +26,7 @@ Example:
Commands
--------
.. _command-praise-add:
add [<channel>] <text>

View File

@ -5,11 +5,13 @@ Documentation for the Protector plugin for Supybot
Purpose
-------
Defends a channel against actions by people who don't have the proper
capabilities, even if they have +o or +h.
Usage
-----
Prevents users from doing things they are not supposed to do on a channel,
even if they have +o or +h.

View File

@ -5,16 +5,19 @@ Documentation for the Quote plugin for Supybot
Purpose
-------
Maintains a Quotes database for each channel.
Usage
-----
This plugin allows you to add quotes to the database for a channel.
.. _commands-Quote:
Commands
--------
.. _command-quote-add:
add [<channel>] <text>

View File

@ -5,6 +5,7 @@ Documentation for the QuoteGrabs plugin for Supybot
Purpose
-------
Quotegrabs are like IRC sound bites. When someone says something funny,
incriminating, stupid, outrageous, ... anything that might be worth
remembering, you can grab that quote for that person. With this plugin, you
@ -13,6 +14,7 @@ as see who "grabbed" the quote in the first place.
Usage
-----
Stores and displays quotes from channels. Quotes are stored randomly
and/or on user request.
@ -20,6 +22,7 @@ and/or on user request.
Commands
--------
.. _command-quotegrabs-get:
get [<channel>] <id>

View File

@ -5,6 +5,7 @@ Documentation for the RSS plugin for Supybot
Purpose
-------
Provides basic functionality for handling RSS/RDF feeds, and allows announcing
them periodically to channels.
In order to use this plugin you must have the following modules
@ -13,6 +14,7 @@ installed:
Usage
-----
This plugin is useful both for announcing updates to RSS feeds in a
channel, and for retrieving the headlines of RSS feeds via command. Use
the "add" command to add feeds to this plugin, and use the "announce"
@ -22,7 +24,7 @@ Basic usage
^^^^^^^^^^^
1. Add a feed using
``@rss add limnoria https://github.com/ProgVal/Limnoria/tags.atom``.
``@rss add limnoria https://github.com/progval/Limnoria/tags.atom``.
* This is RSS feed of Limnoria's stable releases.
* You can now check the latest news from the feed with ``@limnoria``.
@ -54,6 +56,7 @@ and understand what it says and then you can do
Commands
--------
.. _command-rss-add:
add <name> <url>

View File

@ -5,10 +5,12 @@ Documentation for the Relay plugin for Supybot
Purpose
-------
Handles relaying between networks.
Usage
-----
This plugin allows you to setup a relay between networks.
Note that you must tell the bot to join the channel you wish to relay on
@ -24,6 +26,7 @@ https://limnoria.net/plugins.xhtml#messaging
Commands
--------
.. _command-relay-join:
join [<channel>]

View File

@ -5,11 +5,13 @@ Documentation for the Reply plugin for Supybot
Purpose
-------
This plugin contains various commands which elicit certain types of responses
from the bot.
Usage
-----
This plugin contains a few commands that construct various types of
replies. Some bot owners would be wise to not load this plugin because it
can be easily abused.
@ -18,6 +20,7 @@ can be easily abused.
Commands
--------
.. _command-reply-action:
action <text>

View File

@ -5,6 +5,7 @@ Documentation for the Scheduler plugin for Supybot
Purpose
-------
Gives the user the ability to schedule commands to run at a particular time,
or repeatedly run at a particular interval. For example,
``scheduler add [time seconds 30m] "utilities echo [status cpu]"``
@ -12,12 +13,14 @@ will schedule the command `cpu` to be sent to the channel in 30 minutes.
Usage
-----
This plugin allows you to schedule commands to execute at a later time.
.. _commands-Scheduler:
Commands
--------
.. _command-scheduler-add:
add <seconds> <command>

View File

@ -5,10 +5,12 @@ Documentation for the SedRegex plugin for Supybot
Purpose
-------
History replacer using sed-style expressions.
Usage
-----
Enable SedRegex on the desired channels:
``config channel #yourchannel plugins.sedregex.enable True``
After enabling SedRegex, typing a regex in the form

View File

@ -5,12 +5,14 @@ Documentation for the Seen plugin for Supybot
Purpose
-------
Keeps track of the last time a user was seen on a channel
and what they last said.
It also allows you to see what you missed since you parted the channel.
Usage
-----
This plugin allows you to see when and what someone last said and
what you missed since you left a channel.
@ -18,6 +20,7 @@ what you missed since you left a channel.
Commands
--------
.. _command-seen-any:
any [<channel>] [--user <name>] [<nick>]

View File

@ -5,11 +5,13 @@ Documentation for the Services plugin for Supybot
Purpose
-------
Services: Handles management of nicks with NickServ, and ops with ChanServ;
to (re)gain access to its own nick and channels.
Usage
-----
This plugin handles dealing with Services on networks that provide them.
Basically, you should use the "password" command to tell the bot a nick to
identify with and what password to use to identify with that nick. You can
@ -23,6 +25,7 @@ necessary if the bot is properly configured.
Commands
--------
.. _command-services-chanserv:
chanserv <text>

View File

@ -5,10 +5,12 @@ Documentation for the ShrinkUrl plugin for Supybot
Purpose
-------
Shrinks URLs using various URL shortening services, like tinyurl.
Usage
-----
This plugin features commands to shorten URLs through different services,
like tinyurl.
@ -16,6 +18,7 @@ like tinyurl.
Commands
--------
.. _command-shrinkurl-tiny:
tiny <url>

View File

@ -5,11 +5,13 @@ Documentation for the Status plugin for Supybot
Purpose
-------
A simple module to handle various informational commands querying the bot's
current status and statistics, like its uptime.
Usage
-----
This plugin allows you to view different bot statistics, for example,
uptime.
@ -17,6 +19,7 @@ uptime.
Commands
--------
.. _command-status-cmd:
cmd takes no arguments

View File

@ -5,16 +5,19 @@ Documentation for the String plugin for Supybot
Purpose
-------
Provides various commands to manipulate characters and strings.
Usage
-----
Provides useful commands for manipulating characters and strings.
.. _commands-String:
Commands
--------
.. _command-string-chr:
chr <number>

View File

@ -5,12 +5,14 @@ Documentation for the Success plugin for Supybot
Purpose
-------
The Success plugin spices up success replies by allowing custom messages
instead of the default 'The operation succeeded.' message;
like Dunno does for "no such command" replies.
Usage
-----
This plugin was written initially to work with MoobotFactoids, the two
of them to provide a similar-to-moobot-and-blootbot interface for factoids.
Basically, it replaces the standard 'The operation succeeded.' messages
@ -21,6 +23,7 @@ responses.
Commands
--------
.. _command-success-add:
add [<channel>] <text>

View File

@ -5,16 +5,19 @@ Documentation for the Time plugin for Supybot
Purpose
-------
A plugin for time-related functions.
Usage
-----
This plugin allows you to use different time-related functions.
.. _commands-Time:
Commands
--------
.. _command-time-at:
at [<time string>]
@ -47,7 +50,7 @@ time [<channel>] [<format>] [<seconds since epoch>]
.. _command-time-tztime:
tztime <region>/<city>
tztime <region>/<city> (or <region>/<state>/<city>
Takes a city and its region, and returns its local time. This command uses the IANA Time Zone Database.
.. _command-time-until:

View File

@ -5,11 +5,13 @@ Documentation for the Todo plugin for Supybot
Purpose
-------
The Todo plugin allows registered users to keep their own personal list of
tasks to do, with an optional priority for each.
Usage
-----
This plugin allows you to create your own personal to-do list on
the bot.
@ -17,6 +19,7 @@ the bot.
Commands
--------
.. _command-todo-add:
add [--priority=<num>] <text>

View File

@ -5,10 +5,12 @@ Documentation for the Topic plugin for Supybot
Purpose
-------
Provides commands for manipulating channel topics.
Usage
-----
This plugin allows you to use many topic-related functions,
such as Add, Undo, and Remove.
@ -16,6 +18,7 @@ such as Add, Undo, and Remove.
Commands
--------
.. _command-topic-add:
add [<channel>] <topic>

View File

@ -5,12 +5,14 @@ Documentation for the URL plugin for Supybot
Purpose
-------
Keeps track of URLs posted to a channel, along with relevant context. Allows
searching for URLs and returning random URLs. Also provides statistics on the
URLs in the database.
Usage
-----
This plugin records how many URLs have been mentioned in
a channel and what the last URL was.
@ -18,6 +20,7 @@ a channel and what the last URL was.
Commands
--------
.. _command-url-last:
last [<channel>] [--{from,with,without,near,proto} <value>] [--nolimit]

View File

@ -5,16 +5,19 @@ Documentation for the Unix plugin for Supybot
Purpose
-------
Provides commands available only on Unix.
Usage
-----
Provides Utilities for Unix-like systems.
.. _commands-Unix:
Commands
--------
.. _command-unix-call:
call <command to call with any arguments>

View File

@ -5,10 +5,12 @@ Documentation for the User plugin for Supybot
Purpose
-------
Provides commands useful to users in general. This plugin is loaded by default.
Usage
-----
Provides commands for dealing with users, such as registration and
authentication to the bot. This is a core Supybot plugin that should
not be removed!
@ -17,6 +19,7 @@ not be removed!
Commands
--------
.. _command-user-capabilities:
capabilities [<name>]

View File

@ -5,16 +5,19 @@ Documentation for the Utilities plugin for Supybot
Purpose
-------
Various utility commands, mostly useful for manipulating nested commands.
Usage
-----
Provides useful commands for bot scripting / command nesting.
.. _commands-Utilities:
Commands
--------
.. _command-utilities-apply:
apply <command> <text>

View File

@ -5,16 +5,19 @@ Documentation for the Web plugin for Supybot
Purpose
-------
This plugin allows you to view website information, like the title of a page. Also provides a Snarfer for URLs.
Usage
-----
Add the help for 'help Web' here.
.. _commands-Web:
Commands
--------
.. _command-web-doctype:
doctype <url>

View File

@ -113,6 +113,7 @@ class PluginDoc(object):
self.lines.append('')
self.appendLine('Purpose')
self.appendLine('-------')
self.lines.append('')
pdoc = getattr(self.mod, '__doc__',
'My author didn\'t give me a purpose.')
self.appendLine(pdoc)
@ -121,6 +122,7 @@ class PluginDoc(object):
if cdoc is not None:
self.appendLine('Usage')
self.appendLine('-----')
self.lines.append('')
# We add spaces at the beginning in case the docstring does not
# start with a newline (the default, unfortunately)
self.appendLine(textwrap.dedent(" "* 1000 + cdoc).lstrip())
@ -130,6 +132,7 @@ class PluginDoc(object):
self.lines.append('.. _commands-%s:\n' % self.name)
self.appendLine('Commands')
self.appendLine('--------')
self.lines.append('')
for command in commands:
log.debug('command: %s', command)
self.lines.append('.. _command-%s-%s:\n' %