Limnoria-doc/use/plugins/config.rst

83 lines
2.0 KiB
ReStructuredText
Raw Normal View History

2011-06-28 08:11:32 +02:00
.. _plugin-config:
The Config plugin
=================
2011-06-28 17:29:38 +02:00
Accessing config
----------------
2011-06-28 08:11:32 +02:00
2011-06-28 17:29:38 +02:00
.. _command-config-help:
2011-06-28 08:11:32 +02:00
2011-06-28 17:29:38 +02:00
config help <name>
^^^^^^^^^^^^^^^^^^
2011-06-28 08:11:32 +02:00
2011-06-28 17:29:38 +02:00
Returns the description of the configuration variable *<name>*.
2011-06-28 08:11:32 +02:00
2011-06-28 17:29:38 +02:00
.. _command-config-default:
2011-06-28 08:11:32 +02:00
2011-06-28 17:29:38 +02:00
config default <name>
^^^^^^^^^^^^^^^^^^^^^
2011-06-28 08:11:32 +02:00
Returns the default value of the configuration variable *<name>*.
2011-06-28 17:29:38 +02:00
.. _command-config-list:
2011-06-28 08:11:32 +02:00
2011-06-28 17:29:38 +02:00
config list <group>
^^^^^^^^^^^^^^^^^^^
2011-06-28 08:11:32 +02:00
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 a 'ChannelValue', that is,
it can be separately configured for each channel using the 'channel'
command in this plugin, it is preceded by an '#' sign.
2011-06-28 17:29:38 +02:00
.. _command-config-search:
2011-06-28 08:11:32 +02:00
2011-06-28 17:29:38 +02:00
config search <word>
^^^^^^^^^^^^^^^^^^^^
2011-06-28 08:11:32 +02:00
Searches for *<word>* in the current configuration variables.
2011-06-28 17:29:38 +02:00
.. _command-config-channel:
2011-06-28 08:11:32 +02:00
2011-06-28 17:29:38 +02:00
config channel [<channel>] <name> [<value>]
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2011-06-28 08:11:32 +02:00
If *<value>* is given, sets the channel configuration variable for *<name>*
to *<value>* for *<channel>*. Otherwise, returns the current channel
configuration value of *<name>*. *<channel>* is only necessary if the
message isn't sent in the channel itself.
2011-06-28 17:29:38 +02:00
.. _command-config-config:
2011-06-28 08:11:32 +02:00
2011-06-28 17:29:38 +02:00
config config <name> [<value>]
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2011-06-28 08:11:32 +02:00
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.
2011-06-28 17:29:38 +02:00
Maintenance
-----------
.. _command-config-reload:
config reload
^^^^^^^^^^^^^
Reloads the various configuration files (user database, channel
database, registry, etc.).
.. _command-config-export:
config 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.