63eb6672ea
This commit reverts db7ef3f02517f9f2a3c56829a22b9fad3c36e374 (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 db7ef3f02517f9f2a3c56829a22b9fad3c36e374 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.
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 Note plugin.
Use the later tell command to leave a message to a user.
If you sent the message by accident or want to cancel it, you can use
the later undo command to remove the
latest later, which you have sent.
You can also see the people who have notes waiting for them by using
the later notes command. If you specify a
nickname in later notes command, you will see the notes,
which are waiting for the nickname.
Privacy
As you probably noticed from above, this plugin isn't private. Everyone can see notes sent by anyone and the laters are sent on channel by default and as the "plugin help later" says:
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 Note plugin.The Note plugin identifies people by username instead of nickname and allows only users to send notes. The only people who are able to read notes are the sender, receiver, and the owner.
Commands
- notes [<nick>]
-
If <nick> is given, replies with what notes are waiting on <nick>, otherwise, replies with the nicks that have notes waiting for them.
- remove <nick>
-
Removes the notes waiting on <nick>.
- tell <nick1[,nick2[,...]]> <text>
-
Tells each <nickX> <text> the next time <nickX> is seen. <nickX> can contain wildcard characters, and the first matching nick will be given the note.
- undo <nick>
-
Removes the latest note you sent to <nick>.
Configuration
- supybot.plugins.Later.format
-
This is a group of:
- supybot.plugins.Later.format.senderHostname
-
This config variable defaults to "False", is not network-specific, and is not channel-specific.
Determines whether senders' hostname will be shown in messages (instead of just the nick).
- supybot.plugins.Later.maximum
-
This config variable defaults to "0", is not network-specific, and is not channel-specific.
Determines the maximum number of messages to be queued for a user. If this value is 0, there is no maximum.
- supybot.plugins.Later.messageExpiry
-
This config variable defaults to "30", is not network-specific, and is not channel-specific.
Determines the maximum number of days that a message will remain queued for a user. After this time elapses, the message will be deleted. If this value is 0, there is no maximum.
- supybot.plugins.Later.private
-
This config variable defaults to "False", is not network-specific, and is not channel-specific.
Determines whether users will be notified in the first place in which they're seen, or in private.
- supybot.plugins.Later.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.Later.tellOnJoin
-
This config variable defaults to "False", is not network-specific, and is not channel-specific.
Determines whether users will be notified upon joining any channel the bot is in, or only upon sending a message.