From 146d72fddbcc443e402b3aadcf1eb8195b9d4ab5 Mon Sep 17 00:00:00 2001 From: Peter Powell Date: Fri, 21 Jun 2013 03:52:56 +0100 Subject: Fix Doxygen comments. --- include/channels.h | 2 +- include/command_parse.h | 1 + include/inspircd.h | 8 ++++---- include/listmode.h | 5 +++-- include/modules.h | 4 ++-- include/timer.h | 1 - include/users.h | 8 ++++---- 7 files changed, 15 insertions(+), 14 deletions(-) (limited to 'include') diff --git a/include/channels.h b/include/channels.h index 566eb5cfb..b4977eef1 100644 --- a/include/channels.h +++ b/include/channels.h @@ -218,7 +218,7 @@ class CoreExport Channel : public Extensible, public InviteBase * @param user The user to join to the channel * @param privs Priviliges (prefix mode letters) to give to this user, may be NULL * @param bursting True if this join is the result of a netburst (passed to modules in the OnUserJoin hook) - * @param created True if this channel was just created by a local user (passed to modules in the OnUserJoin hook) + * @param created_by_local True if this channel was just created by a local user (passed to modules in the OnUserJoin hook) */ void ForceJoin(User* user, const std::string* privs = NULL, bool bursting = false, bool created_by_local = false); diff --git a/include/command_parse.h b/include/command_parse.h index b39bf31c0..f9ea1df7f 100644 --- a/include/command_parse.h +++ b/include/command_parse.h @@ -123,6 +123,7 @@ class CoreExport CommandParser * @param item The input string * @param dest The output string. The translation result will be appended to this string * @param custom_translator Used to translate the parameter if the translation type is TR_CUSTOM, if NULL, TR_CUSTOM will act like TR_TEXT + * @param paramnumber The index of the parameter we are translating. */ static void TranslateSingleParam(TranslateType to, const std::string& item, std::string& dest, Command* custom_translator = NULL, unsigned int paramnumber = 0); diff --git a/include/inspircd.h b/include/inspircd.h index a25466647..a634eb2c8 100644 --- a/include/inspircd.h +++ b/include/inspircd.h @@ -478,7 +478,7 @@ class CoreExport InspIRCd caller1 IsChannel; /** Return true if str looks like a server ID - * @param string to check against + * @param sid string to check against */ static bool IsSID(const std::string& sid); @@ -509,9 +509,9 @@ class CoreExport InspIRCd */ static void QuickExit(int status); - /** Printf-wrapper. - * @param How you want it formatted - * @param ... + /** Formats the input string with the specified arguments. + * @param formatString The string to format + * @param ... A variable number of format arguments. * @return The formatted string */ static const char* Format(const char* formatString, ...) CUSTOM_PRINTF(1, 2); diff --git a/include/listmode.h b/include/listmode.h index 149f41578..e27071eac 100644 --- a/include/listmode.h +++ b/include/listmode.h @@ -106,7 +106,8 @@ class CoreExport ListModeBase : public ModeHandler public: /** Constructor. - * @param Instance The creator of this class + * @param Creator The creator of this class + * @param Name Mode name * @param modechar Mode character * @param eolstr End of list string * @param lnum List numeric @@ -175,7 +176,7 @@ class CoreExport ListModeBase : public ModeHandler /** Validate parameters. * Overridden by implementing module. - * @param source Source user adding the parameter + * @param user Source user adding the parameter * @param channel Channel the parameter is being added to * @param parameter The actual parameter being added * @return true if the parameter is valid diff --git a/include/modules.h b/include/modules.h index a5f99ee86..1a88a0389 100644 --- a/include/modules.h +++ b/include/modules.h @@ -843,7 +843,7 @@ class CoreExport Module : public classbase, public usecountbase /** Called when a 005 numeric is about to be output. * The module should modify the 005 numeric if needed to indicate its features. - * @param output The 005 map to be modified if neccessary. + * @param tokens The 005 map to be modified if neccessary. */ virtual void On005Numeric(std::map& tokens); @@ -1202,7 +1202,7 @@ class CoreExport FileReader : public classbase FileReader() : totalSize(0) { } /** Initializes a new file reader and reads the specified file. - * @param file The file to read into memory. + * @param filename The file to read into memory. */ FileReader(const std::string& filename); diff --git a/include/timer.h b/include/timer.h index 6f1834178..2887e2b52 100644 --- a/include/timer.h +++ b/include/timer.h @@ -49,7 +49,6 @@ class CoreExport Timer public: /** Default constructor, initializes the triggering time - * @param mod The module that created this timer * @param secs_from_now The number of seconds from now to trigger the timer * @param now The time now * @param repeating Repeat this timer every secs_from_now seconds if set to true diff --git a/include/users.h b/include/users.h index 941e57667..218ec4ae0 100644 --- a/include/users.h +++ b/include/users.h @@ -598,8 +598,8 @@ class CoreExport User : public Extensible void WriteCommonQuit(const std::string &normal_text, const std::string &oper_text); /** Dump text to a user target, splitting it appropriately to fit - * @param LinePrefix text to prefix each complete line with - * @param TextStream the text to send to the user + * @param linePrefix text to prefix each complete line with + * @param textStream the text to send to the user */ void SendText(const std::string& linePrefix, std::stringstream& textStream); @@ -818,7 +818,7 @@ class CoreExport LocalUser : public User, public InviteBase InviteList& GetInviteList(); /** Returns true if a user is invited to a channel. - * @param channel A channel to look up + * @param chan A channel to look up * @return True if the user is invited to the given channel */ bool IsInvited(Channel* chan) { return (Invitation::Find(chan, this) != NULL); } @@ -826,7 +826,7 @@ class CoreExport LocalUser : public User, public InviteBase /** Removes a channel from a users invite list. * This member function is called on successfully joining an invite only channel * to which the user has previously been invited, to clear the invitation. - * @param channel The channel to remove the invite to + * @param chan The channel to remove the invite to * @return True if the user was invited to the channel and the invite was erased, false if the user wasn't invited */ bool RemoveInvite(Channel* chan); -- cgit v1.2.3