From d54f233a5ea7d6fae389f0b2ef8bfc8b80f472e4 Mon Sep 17 00:00:00 2001 From: brain Date: Tue, 8 Aug 2006 19:05:31 +0000 Subject: Document Write* methods in userrec git-svn-id: http://svn.inspircd.org/repository/trunk/inspircd@4799 e03df62e-2008-0410-955e-edbf42e46eb7 --- include/users.h | 37 ++++++++++++++++++++++++++++++++----- 1 file changed, 32 insertions(+), 5 deletions(-) (limited to 'include/users.h') diff --git a/include/users.h b/include/users.h index 689f26e19..2ea805745 100644 --- a/include/users.h +++ b/include/users.h @@ -557,23 +557,50 @@ class userrec : public connection */ long LocalCloneCount(); - /** TO this user + /** Write text to this user, appending CR/LF. + * @param text A std::string to send to the user */ void Write(const std::string &text); + + /** Write text to this user, appending CR/LF. + * @param text The format string for text to send to the user + * @param ... POD-type format arguments + */ void Write(const char *text, ...); - /** FROM server to this user + + /** Write text to this user, appending CR/LF and prepending :server.name + * @param text A std::string to send to the user */ void WriteServ(const std::string& text); + + /** Write text to this user, appending CR/LF and prepending :server.name + * @param text The format string for text to send to the user + * @param ... POD-type format arguments + */ void WriteServ(const char* text, ...); - /** FROM another user TO this user + + /** Write text to this user, appending CR/LF and prepending :nick!user@host of the user provided in the first parameter. + * @param text A std::string to send to the user */ void WriteFrom(userrec *user, const std::string &text); + + /** Write text to this user, appending CR/LF and prepending :nick!user@host of the user provided in the first parameter. + * @param text The format string for text to send to the user + * @param ... POD-type format arguments + */ void WriteFrom(userrec *user, const char* text, ...); - /** TO another user FROM this user + + /** Write text to the user provided in the first parameter, appending CR/LF, and prepending THIS user's :nick!user@host. + * @param text A std::string to send to the user + * @param ... POD-type format arguments */ void WriteTo(userrec *dest, const std::string &data); - void WriteTo(userrec *dest, const char *data, ...); + /** Write text to the user provided in the first parameter, appending CR/LF, and prepending THIS user's :nick!user@host. + * @param text The format string for text to send to the user + * @param ... POD-type format arguments + */ + void WriteTo(userrec *dest, const char *data, ...); /** Default destructor */ -- cgit v1.2.3