From 2b39234be281afda6d23299886b2b2b8f03df2ea Mon Sep 17 00:00:00 2001 From: w00t Date: Sat, 25 Oct 2008 12:59:14 +0000 Subject: [PATCH] Last of documentation for protocol interface. XXX, ProtocolInterface::GetServerList is quite poorly documented. git-svn-id: http://svn.inspircd.org/repository/trunk/inspircd@10709 e03df62e-2008-0410-955e-edbf42e46eb7 --- include/protocol.h | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) diff --git a/include/protocol.h b/include/protocol.h index b6568e313..3d8f86cca 100644 --- a/include/protocol.h +++ b/include/protocol.h @@ -82,22 +82,59 @@ class ProtocolInterface : public Extensible SendMode(target, n); } + /** Send a notice to users with a given mode(s). + * @param modes The modes required for the message to be sent. + * @param text The message to send. + */ virtual void SendModeNotice(const std::string &modes, const std::string &text) { } + /** Send a notice to users with a given snomask. + * @param snomask The snomask required for the message to be sent. + * @param text The message to send. + */ virtual void SendSNONotice(const std::string &snomask, const std::string &text) { } + /** Send raw data to a remote client. + * @param target The user to push data to. + * @param rawline The raw IRC protocol line to deliver (":me NOTICE you :foo", whatever). + */ virtual void PushToClient(User* target, const std::string &rawline) { } + /** Send a message to a channel. + * @param target The channel to message. + * @param status The status character (e.g. %) required to recieve. + * @param text The message to send. + */ virtual void SendChannelPrivmsg(Channel* target, char status, const std::string &text) { } + /** Send a notice to a channel. + * @param target The channel to message. + * @param status The status character (e.g. %) required to recieve. + * @param text The message to send. + */ virtual void SendChannelNotice(Channel* target, char status, const std::string &text) { } + /** Send a message to a user. + * @param target The user to message. + * @param text The message to send. + */ virtual void SendUserPrivmsg(User* target, const std::string &text) { } + /** Send a notice to a user. + * @param target The user to message. + * @param text The message to send. + */ virtual void SendUserNotice(User* target, const std::string &text) { } + /** Fill a list of servers and information about them. + * @param sl The list of servers to fill. + * XXX: document me properly, this is shit. + */ virtual void GetServerList(ProtoServerList &sl) { } + /** Send information about a user connection to linked servers. + * @param u The user to send information about. + */ virtual void Introduce(User* u) { } }; -- 2.39.2