grim/pidgin

Use the leaky bucket algorithm to rate limit irc messages.
draft 2.x.y-irc-rate-limiting
2021-02-24, Gary Kramlich
5bbd0f3a7d4f
Use the leaky bucket algorithm to rate limit irc messages.

The default values were suggested by an operator of freenode.

We don't rate limit the login process, nor parts and quits. However, if you
paste a bunch of text and then part a channel, you will be spammed with a
bunch of "no such nick/channel" error dialogs. I tried to work around this,
but the alternative just makes irc unresponsive until all the pasted messages
are sent. That said, other messages are still delayed while these errors
dialogs are slowly popping up.
/** @page notify-signals Notification Signals
@signals
@signal displaying-userinfo
@signal displaying-email-notification
@signal displaying-emails-notification
@endsignals
@see notify.h
@signaldef displaying-userinfo
@signalproto
void (*displaying_userinfo)(PurpleAccount *account, const char *who, PurpleNotifyUserInfo *user_info);
@endsignalproto
@signaldesc
Emitted before userinfo is handed to the UI to display.
@a user_info can be manipulated via the PurpleNotifyUserInfo API in notify.c.
@note
If adding a PurpleNotifyUserInfoEntry, be sure not to free it -- PurpleNotifyUserInfo assumes responsibility for its objects.
@param account The account on which the info was obtained.
@param who The name of the buddy whose info is to be displayed.
@param user_info The information to be displayed, as PurpleNotifyUserInfoEntry objects
@endsignaldef
@signaldef displaying-email-notification
@signalproto
void (*displaying_email_notification)(const char *subject,
const char *from,
const char *to,
const char *url);
@endsignalproto
@signaldesc
Emitted before notification of a single email is handed to the UI to display.
@param subject Subject of email being notified of.
@param from Who the email is from.
@param to Who the email is to.
@param url A url to view the email.
@since 2.1.0
@endsignaldef
@signaldef displaying-emails-notification
@signalproto
void (*displaying_emails_notification)(const char **subjects,
const char **froms,
const char **tos,
const char **urls,
guint count);
@endsignalproto
@signaldesc
Emitted before notification of multiple emails is handed to the UI to display.
@param subjects Subjects of emails being notified of.
@param froms Who the emails are from.
@param tos Who the emails are to.
@param urls The urls to view the emails.
@param count Number of emails being notified of.
@since 2.1.0
@endsignaldef
*/
// vim: syntax=c.doxygen tw=75 et