Limnoria/plugins/NickAuth
Valentin Lorentz 63eb6672ea Revert generic 'The Limnoria Contributors' in copyright notices
This commit reverts db7ef3f025
(though it keeps the year updates)

After discussion with several people, it seems better to mention
copyright owners explicitly. eg. https://reuse.software/faq/#vcs-copyright
explains the issue of using VCSs to track copyright.

As db7ef3f025 only replaced mentions
of my name with 'The Limnoria Contributors', this commit only needs
to undo that + add one person who contributed to setup.py.
2021-10-17 09:57:55 +02:00
..
local NickAuth: First commit. 2012-11-03 23:06:57 +01:00
locales Fix msgfmt warnings. 2020-03-26 22:10:28 +01:00
__init__.py Revert generic 'The Limnoria Contributors' in copyright notices 2021-10-17 09:57:55 +02:00
config.py Revert generic 'The Limnoria Contributors' in copyright notices 2021-10-17 09:57:55 +02:00
messages.pot Squashed commit of the following: 2014-12-20 14:37:27 +01:00
plugin.py Revert generic 'The Limnoria Contributors' in copyright notices 2021-10-17 09:57:55 +02:00
README.rst all plugins: regenerate READMEs 2021-04-22 00:29:15 +02:00
test.py Revert generic 'The Limnoria Contributors' in copyright notices 2021-10-17 09:57:55 +02:00

.. _plugin-NickAuth:

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.

They first have to use ``@nickauth nick add <the nick>`` while being
identified to the bot and then use ``@auth`` when they want to
identify to the bot.

.. _commands-NickAuth:

Commands
--------
.. _command-nickauth-auth:

auth takes no argument
  Tries to authenticate you using network services. If you get no reply, it means you are not authenticated to the network services.

.. _command-nickauth-nick.add:

nick add [<network>] <user> <nick>
  Add <nick> to the list of nicks owned by the <user> on the <network>. You have to register this nick to the network services to be authenticated. <network> defaults to the current network.

.. _command-nickauth-nick.list:

nick list [<network>] [<user>]
  Lists nicks of the <user> on the network. <network> defaults to the current network.

.. _command-nickauth-nick.remove:

nick remove [<network>] <user> <nick>
  Remove <nick> from the list of nicks owned by the <user> on the <network>. <network> defaults to the current network.

.. _conf-NickAuth:

Configuration
-------------

.. _conf-supybot.plugins.NickAuth.public:


supybot.plugins.NickAuth.public
  This config variable defaults to "True", is not network-specific, and is  not channel-specific.

  Determines whether this plugin is publicly visible.