]> git.netwichtig.de Git - user/henk/code/inspircd.git/commitdiff
Fix various documentation comments.
authorSadie Powell <sadie@witchery.services>
Wed, 31 Mar 2021 09:38:54 +0000 (10:38 +0100)
committerSadie Powell <sadie@witchery.services>
Wed, 31 Mar 2021 09:51:51 +0000 (10:51 +0100)
12 files changed:
include/channels.h
include/inspircd.h
include/mode.h
include/modules/away.h
include/modules/dns.h
include/modules/httpd.h
include/modules/sql.h
include/socketengine.h
include/stdalgo.h
include/users.h
src/coremods/core_reloadmodule.cpp
src/modules/m_rline.cpp

index 1b44a7be6fa7c5e47509c07c649032277142d8ef..0b38958cc456d36c04a8eab6989e34d5f98ce201 100644 (file)
@@ -165,7 +165,6 @@ class CoreExport Channel : public Extensible
 
        /** Delete a user pointer to the internal reference list
         * @param user The user to delete
-        * @return number of users left on the channel after deletion of the user
         */
        void DelUser(User* user);
 
index a55d52c0b0e5dff8a0b2e250e0e9b4ef72d3a13c..b0e9903f24752ef533b13e6a24fbb9431eb55419 100644 (file)
@@ -538,7 +538,6 @@ class CoreExport InspIRCd
        /** Attempt to write the process id to a given file
         * @param filename The PID file to attempt to write to
         * @param exitonfail If true and the PID fail cannot be written log to stdout and exit, otherwise only log on failure
-        * @return This function may bail if the file cannot be written
         */
        void WritePID(const std::string& filename, bool exitonfail = true);
 
index 17f7e01336486981224e9f35f0f207812750c06e..82dd75770a1c4c5fa3b78d6e4551c1ec8866345c 100644 (file)
@@ -681,7 +681,7 @@ class CoreExport ModeParser : public fakederef<ModeParser>
         *
         * host.name -> *!*\@host.name
         *
-        * ident@host.name -> *!ident\@host.name
+        * ident\@host.name -> *!ident\@host.name
         *
         * This method can be used on both IPV4 and IPV6 user masks.
         */
index e70b598cf51a4dd86f1e52895e8b2748d58e608d..563b599fe81888ac357f4428f3a125554fb30f2f 100644 (file)
@@ -51,7 +51,6 @@ class Away::EventListener
 
        /** Called when a user wishes to mark themselves as back.
         * @param user The user who is going away.
-        * @param message The away message that the user set.
         * @return Either MOD_RES_ALLOW to allow the user to mark themself as back, MOD_RES_DENY to
         *         disallow the user to mark themself as back, or MOD_RES_PASSTHRU to let another module
         *         handle the event.
index 141951fd30911187ed16a69449f34a114df1ebdc..5b1c426cd5e6644af9af0f6f0a3ae438996473c2 100644 (file)
@@ -182,12 +182,12 @@ namespace DNS
                }
 
                /** Called when this request succeeds
-                * @param r The query sent back from the nameserver
+                * @param req The query sent back from the nameserver
                 */
                virtual void OnLookupComplete(const Query* req) = 0;
 
                /** Called when this request fails or times out.
-                * @param r The query sent back from the nameserver, check the error code.
+                * @param req The query sent back from the nameserver, check the error code.
                 */
                virtual void OnError(const Query* req) { }
 
index dca35f0992e26633472b418a9bbb7c6314d6a992..ccb71595c5d5ab8d2c3222c4f7712f2381fdcb36 100644 (file)
@@ -186,17 +186,18 @@ class HTTPRequest
        /** Initialize HTTPRequest.
         * This constructor is called by m_httpd.so to initialize the class.
         * @param request_type The request type, e.g. GET, POST, HEAD
+        * @param parsed_uri The URI which was requested by the client.
         * @param hdr The headers sent with the request
-        * @param opaque An opaque pointer used internally by m_httpd, which you must pass back to the module in your reply.
+        * @param socket The server socket which this request came in via.
         * @param ip The IP address making the web request.
         * @param pdata The post data (content after headers) received with the request, up to Content-Length in size
         */
-       HTTPRequest(const std::string& request_type, const HTTPRequestURI& Parseduri,
-               HTTPHeaders* hdr, HttpServerSocket* socket, const std::string &ip, const std::string &pdata)
+       HTTPRequest(const std::string& request_type, const HTTPRequestURI& parsed_uri, HTTPHeaders* hdr,
+                       HttpServerSocket* socket, const std::string& ip, const std::string& pdata)
                : type(request_type)
                , ipaddr(ip)
                , postdata(pdata)
-               , parseduri(Parseduri)
+               , parseduri(parsed_uri)
                , headers(hdr)
                , sock(socket)
        {
index 47da6f6bff2a3c40cad577678613ce47c8d4b9b9..292322cda7265e504636a2ce77900ca3c2314527 100644 (file)
@@ -129,9 +129,9 @@ class SQL::Result : public classbase
        /**
         * Check if there's a column with the specified name in the result
         *
-        * @param the column name
-        * @param on success, this is the column index
-        * @returns true, or false if the column is not found
+        * @param column The column name.
+        * @param index The place to store the column index if it exists.
+        * @returns If the column exists then true; otherwise, false.
         */
        virtual bool HasColumn(const std::string& column, size_t& index) = 0;
 };
index 26d31c168d1c9ff77d9847ddc8f20d7644240e79..d8d5e406dc5c28a0fc924e9fc6d7b91a23b53407 100644 (file)
@@ -326,8 +326,6 @@ public:
         * failure (for example, you try and enable
         * epoll on a 2.4 linux kernel) then this
         * function may bail back to the shell.
-        * @return void, but it is acceptable for this function to bail back to
-        * the shell or operating system on fatal error.
         */
        static void Init();
 
@@ -556,8 +554,6 @@ public:
         * allows for the socket engine to re-create its handle
         * after the daemon forks as the socket engine is created
         * long BEFORE the daemon forks.
-        * @return void, but it is acceptable for this function to bail back to
-        * the shell or operating system on fatal error.
         */
        static void RecoverFromFork();
 
index c0baa9dd8ef843de3050dfea8c1f8d435326032f..585114fce93474127c456cfad47331bcb3d17359 100644 (file)
@@ -28,10 +28,10 @@ namespace stdalgo
                 * Erase a single element from a vector by overwriting it with a copy of the last element,
                 * which is then removed. This, in contrast to vector::erase(), does not result in all
                 * elements after the erased element being moved.
+                * Returns nothing, but all iterators, references and pointers to the erased element and the
+                * last element are invalidated
                 * @param vect Vector to remove the element from
                 * @param it Iterator to the element to remove
-                * @return Nothing, but all iterators, references and pointers to the erased element and the
-                * last element are invalidated
                 */
                template <typename T>
                inline void swaperase(typename std::vector<T>& vect, const typename std::vector<T>::iterator& it)
index 136874bab29fa48edd0b0a0f4d50b9c9b5cbfe09..8045d57050c5d56ff670e27f7aae466ebec11146 100644 (file)
@@ -243,19 +243,19 @@ struct CoreExport ConnectClass : public refcountbase
 class CoreExport User : public Extensible
 {
  private:
-       /** Cached nick!ident@dhost value using the displayed hostname
+       /** Cached nick!ident\@dhost value using the displayed hostname
         */
        std::string cached_fullhost;
 
-       /** Cached ident@ip value using the real IP address
+       /** Cached ident\@ip value using the real IP address
         */
        std::string cached_hostip;
 
-       /** Cached ident@realhost value using the real hostname
+       /** Cached ident\@realhost value using the real hostname
         */
        std::string cached_makehost;
 
-       /** Cached nick!ident@realhost value using the real hostname
+       /** Cached nick!ident\@realhost value using the real hostname
         */
        std::string cached_fullrealhost;
 
@@ -850,7 +850,6 @@ class CoreExport LocalUser : public User, public insp::intrusive_list_node<Local
 
        /** Set the connect class to which this user belongs to.
         * @param explicit_name Set this string to tie the user to a specific class name. Otherwise, the class is fitted by checking \<connect> tags from the configuration file.
-        * @return A reference to this user's current connect class.
         */
        void SetClass(const std::string &explicit_name = "");
 
index 6836cb55cf7bb01391bee6664f6f4281339b58f3..ef0b139629aa556989ba94b6817651af6bff8c7b 100644 (file)
@@ -284,7 +284,7 @@ class DataKeeper
 
        /** Restore all modes and extensions of all members on a channel
         * @param chan Channel whose members are being restored
-        * @param memberdata Data to restore
+        * @param memberdatalist Data to restore
         * @param modechange Mode change to populate with prefix modes
         */
        void RestoreMemberData(Channel* chan, const std::vector<ChanData::MemberData>& memberdatalist, Modes::ChangeList& modechange);
index 7ef766b7de3b7ff473b1956873905eb57389ea76..f4c675919313fba688290ac00d8cb9eb8a98c713 100644 (file)
@@ -37,15 +37,6 @@ static bool added_zline = false;
 class RLine : public XLine
 {
  public:
-
-       /** Create a R-line.
-        * @param s_time The set time
-        * @param d The duration of the xline
-        * @param src The sender of the xline
-        * @param re The reason of the xline
-        * @param regex Pattern to match with
-        * @
-        */
        RLine(time_t s_time, unsigned long d, const std::string& src, const std::string& re, const std::string& regexs, dynamic_reference<RegexFactory>& rxfactory)
                : XLine(s_time, d, src, re, "R")
                , matchtext(regexs)
@@ -56,8 +47,6 @@ class RLine : public XLine
                regex = rxfactory->Create(regexs);
        }
 
-       /** Destructor
-        */
        ~RLine()
        {
                delete regex;