]> git.netwichtig.de Git - user/henk/code/inspircd.git/commitdiff
Fix warnings from Doxygen.
authorPeter Powell <petpow@saberuk.com>
Sun, 21 Oct 2018 18:18:08 +0000 (19:18 +0100)
committerPeter Powell <petpow@saberuk.com>
Sun, 21 Oct 2018 18:18:08 +0000 (19:18 +0100)
include/channels.h
include/clientprotocol.h
include/clientprotocolmsg.h
include/configreader.h
include/event.h
include/hashcomp.h
include/inspircd.h
include/inspsocket.h
include/modules.h

index 0557a5898b5974b74b7334eddc7f28f97f5d49a5..22a373a0fa155d50dd4d34e3efa4d3643b7b7782 100644 (file)
@@ -235,7 +235,6 @@ class CoreExport Channel : public Extensible
        /** Write to all users on a channel except some users
         * @param protoev Event to send, may contain any number of messages.
         * @param status The status of the users to write to, e.g. '@' or '%'. Use a value of 0 to write to everyone
-        * @param text A std::string containing the output line without prefix
         * @param except_list List of users not to send to
         */
        void Write(ClientProtocol::Event& protoev, char status = 0, const CUList& except_list = CUList());
@@ -244,7 +243,6 @@ class CoreExport Channel : public Extensible
         * @param protoevprov Protocol event provider for the message.
         * @param msg Message to send.
         * @param status The status of the users to write to, e.g. '@' or '%'. Use a value of 0 to write to everyone
-        * @param text A std::string containing the output line without prefix
         * @param except_list List of users not to send to
         */
        void Write(ClientProtocol::EventProvider& protoevprov, ClientProtocol::Message& msg, char status = 0, const CUList& except_list = CUList());
index a3efcf98484f7c8cb32f8b411423d9932c7f075a..260e463eb10f84e89a5f7c9952dadb14966c8c16 100644 (file)
@@ -467,7 +467,7 @@ class ClientProtocol::Event
 
  public:
        /** Constructor.
-        * @param protoevent Protocol event provider the event is an instance of.
+        * @param protoeventprov Protocol event provider the event is an instance of.
         */
        Event(EventProvider& protoeventprov)
                : event(&protoeventprov)
@@ -478,7 +478,7 @@ class ClientProtocol::Event
        }
 
        /** Constructor.
-        * @param protoevent Protocol event provider the event is an instance of.
+        * @param protoeventprov Protocol event provider the event is an instance of.
         * @param msg Message to include in this event by default.
         */
        Event(EventProvider& protoeventprov, ClientProtocol::Message& msg)
@@ -544,7 +544,7 @@ class ClientProtocol::MessageTagProvider : public Events::ModuleEventListener
        /** Called for each tag that the server receives from a client in a message.
         * @param user User that sent the tag.
         * @param tagname Name of the tag.
-        * @param value Value of the tag, empty string if the tag has no value. May be modified.
+        * @param tagvalue Value of the tag, empty string if the tag has no value. May be modified.
         * @return MOD_RES_ALLOW to accept the tag with the value in 'value', MOD_RES_DENY to reject the tag and act as if it wasn't sent,
         * MOD_RES_PASSTHRU to make no decision. If no hooks accept a tag, the tag is rejected.
         * The default implementation returns MOD_RES_PASSTHRU.
index d1562d7d10207663cb36b5c578e3ab28957ed236..d2f838d69af3c667e3455dfab111c214121cdb11 100644 (file)
@@ -484,7 +484,7 @@ class ClientProtocol::Messages::Privmsg : public ClientProtocol::Message
 
        /** Constructor, string source, string target, copies text.
         * @param source Source user.
-        * @param targetuser Target user.
+        * @param target Target string.
         * @param text Privmsg text, will be copied.
         * @param mt Message type.
         */
@@ -524,7 +524,7 @@ class ClientProtocol::Messages::Privmsg : public ClientProtocol::Message
 
        /** Constructor, user source, string target, copies text.
         * @param source Source user.
-        * @param targetuser Target string.
+        * @param target Target string.
         * @param text Privmsg text, will not be copied.
         * @param mt Message type.
         */
@@ -564,7 +564,7 @@ class ClientProtocol::Messages::Privmsg : public ClientProtocol::Message
 
        /** Constructor, string source, string target, does not copy text.
         * @param source Source string.
-        * @param targetuser Target string.
+        * @param target Target string.
         * @param text Privmsg text, will not be copied.
         * @param mt Message type.
         */
@@ -591,7 +591,7 @@ class ClientProtocol::Messages::Privmsg : public ClientProtocol::Message
 
        /** Constructor, string source, user target, does not copy text.
         * @param source Source string.
-        * @param targetchan Target user.
+        * @param targetuser Target user.
         * @param text Privmsg text, will not be copied.
         * @param mt Message type.
         */
index c63ea717afcfb605d49cd634c4bf7b96313c606e..1db64ae5a6af7890a7512ed76167e9a3892ba458 100644 (file)
@@ -150,12 +150,12 @@ struct CommandLineConf
 
        /** If this is true, a PID file will be written
         * to the file given in the "file" variable of
-        * the <pid> tag in the config file. This is
+        * the \<pid> tag in the config file. This is
         * the default.
         * Passing --nopid as a command line argument
         * sets this to false; in this case, a PID file
         * will not be written, even the default PID
-        * file that is usually written when the <pid>
+        * file that is usually written when the \<pid>
         * tag is not defined in the config file.
         */
        bool writepid;
index 73a45a5419a7396950851e210078e7cdebfb6aa3..1bcb0a5edaf17066d2f533a36d957ccfe663cdda 100644 (file)
@@ -104,6 +104,7 @@ class Events::ModuleEventListener : private dynamic_reference_base::CaptureHook
        /** Constructor
         * @param mod Module subscribing
         * @param eventid Identifier of the event to subscribe to
+        * @param eventprio The priority to give this event listener
         */
        ModuleEventListener(Module* mod, const std::string& eventid, unsigned int eventprio = DefaultPriority)
                : prov(mod, eventid)
index b9c568135f7da730de600a0308ea288f022e4b19..f0e092729d9618cec08e4b01972280721af3a022 100644 (file)
@@ -199,13 +199,13 @@ namespace irc
                /** Create a tokenstream and fill it with the provided data. */
                tokenstream(const std::string& msg, size_t start = 0);
 
-               /** Retrieve the next <middle> token in the token stream.
+               /** Retrieve the next \<middle> token in the token stream.
                 * @param token The next token available, or an empty string if none remain.
                 * @return True if tokens are left to be read, false if the last token was just retrieved.
                 */
                bool GetMiddle(std::string& token);
 
-               /** Retrieve the next <trailing> token in the token stream.
+               /** Retrieve the next \<trailing> token in the token stream.
                 * @param token The next token available, or an empty string if none remain.
                 * @return True if tokens are left to be read, false if the last token was just retrieved.
                 */
index 934f2f82bca4510760dbaf5c4859f024a6f67f8b..1e0ca19259dad3fb74d61fb4b39a01fe8b58d043 100644 (file)
@@ -348,9 +348,9 @@ class CoreExport InspIRCd
        static void DefaultGenRandom(char* output, size_t max);
 
        /** Bind to a specific port from a config tag.
-        * @param Tag the tag that contains bind information.
+        * @param tag the tag that contains bind information.
         * @param sa The endpoint to listen on.
-        * @params old_ports Previously listening ports that may be on the same endpoint.
+        * @param old_ports Previously listening ports that may be on the same endpoint.
         */
        bool BindPort(ConfigTag* tag, const irc::sockets::sockaddrs& sa, std::vector<ListenSocket*>& old_ports);
 
index 5bdbfd6524ec5bc395880b99dd4f9a147d078ebd..d88c350ba966a2fb58d76e8629aca096ad2f3b7f 100644 (file)
@@ -301,7 +301,7 @@ class CoreExport StreamSocket : public EventHandler
         * @param local The new local endpoint.
         * @param remote The new remote endpoint.
         */
-       virtual void OnSetEndPoint(const irc::sockets::sockaddrs& server, const irc::sockets::sockaddrs& remote) { }
+       virtual void OnSetEndPoint(const irc::sockets::sockaddrs& local, const irc::sockets::sockaddrs& remote) { }
 
        /** Send the given data out the socket, either now or when writes unblock
         */
index 43ab2ae3ad211d6c698bb64df3447092bfd8df88..8acf9089d336fa2c64e1676a739cb115d0a9246f 100644 (file)
@@ -570,7 +570,7 @@ class CoreExport Module : public classbase, public usecountbase
        /** Called whenever a user's real name is changed.
         * This event triggers after the name has been set.
         * @param user The user who's real name is being changed
-        * @param name The new real name being set on the user
+        * @param real The new real name being set on the user
         */
        virtual void OnChangeRealName(User* user, const std::string& real);