mirror of
https://github.com/Mikaela/Limnoria.git
synced 2024-12-26 12:43:09 +01:00
105 lines
3.8 KiB
ReStructuredText
105 lines
3.8 KiB
ReStructuredText
.. _plugin-Config:
|
|
|
|
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!
|
|
|
|
.. _commands-Config:
|
|
|
|
Commands
|
|
--------
|
|
|
|
.. _command-config-channel:
|
|
|
|
channel [<network>] [<channel>] <name> [<value>]
|
|
If <value> is given, sets the channel configuration variable for <name> to <value> for <channel> on the <network>. Otherwise, returns the current channel configuration value of <name>. <channel> is only necessary if the message isn't sent in the channel itself. More than one channel may be given at once by separating them with commas. <network> defaults to the current network.
|
|
|
|
.. _command-config-config:
|
|
|
|
config <name> [<value>]
|
|
If <value> is given, sets the value of <name> to <value>. Otherwise, returns the current value of <name>. You may omit the leading "supybot." in the name if you so choose.
|
|
|
|
.. _command-config-default:
|
|
|
|
default <name>
|
|
Returns the default value of the configuration variable <name>.
|
|
|
|
.. _command-config-export:
|
|
|
|
export <filename>
|
|
Exports the public variables of your configuration to <filename>. If you want to show someone your configuration file, but you don't want that person to be able to see things like passwords, etc., this command will export a "sanitized" configuration file suitable for showing publicly.
|
|
|
|
.. _command-config-help:
|
|
|
|
help <name>
|
|
Returns the description of the configuration variable <name>.
|
|
|
|
.. _command-config-list:
|
|
|
|
list <group>
|
|
Returns the configuration variables available under the given configuration <group>. If a variable has values under it, it is preceded by an '@' sign. If a variable is channel-specific, that is, it can be separately configured for each channel using the 'channel' command in this plugin, it is preceded by an '#' sign. And if a variable is a network-specific, it is preceded by a ':' sign.
|
|
|
|
.. _command-config-network:
|
|
|
|
network [<network>] <name> [<value>]
|
|
If <value> is given, sets the network configuration variable for <name> to <value> for <network>. Otherwise, returns the current network configuration value of <name>. <network> defaults to the current network.
|
|
|
|
.. _command-config-reload:
|
|
|
|
reload takes no arguments
|
|
Reloads the various configuration files (user database, channel database, registry, etc.).
|
|
|
|
.. _command-config-reset.channel:
|
|
|
|
reset channel [<network>] [<channel>] <name>
|
|
Resets the channel-specific value of variable <name>, so that it will match the network-specific value (or the global one if the latter isn't set). <network> and <channel> default to the current network and channel.
|
|
|
|
.. _command-config-reset.network:
|
|
|
|
reset network [<network>] [<channel>] <name>
|
|
Resets the network-specific value of variable <name>, so that it will match the global. <network> defaults to the current network and channel.
|
|
|
|
.. _command-config-search:
|
|
|
|
search <word>
|
|
Searches for <word> in the current configuration variables.
|
|
|
|
.. _command-config-searchhelp:
|
|
|
|
searchhelp <phrase>
|
|
Searches for <phrase> in the help of current configuration variables.
|
|
|
|
.. _command-config-searchvalues:
|
|
|
|
searchvalues <word>
|
|
Searches for <word> in the values of current configuration variables.
|
|
|
|
.. _command-config-setdefault:
|
|
|
|
setdefault <name>
|
|
Resets the configuration variable <name> to its default value. Use commands 'reset channel' and 'reset network' instead to make a channel- or network- specific value inherit from the global one.
|
|
|
|
.. _conf-Config:
|
|
|
|
Configuration
|
|
-------------
|
|
|
|
.. _conf-supybot.plugins.Config.public:
|
|
|
|
|
|
supybot.plugins.Config.public
|
|
This config variable defaults to "True", is not network-specific, and is not channel-specific.
|
|
|
|
Determines whether this plugin is publicly visible.
|
|
|