Merge pull request #173 from Robby-/insp20-moddesc

[2.0] Module description updates

diff --git a/docs/modules.conf.example b/docs/modules.conf.example
index 977d628e65c1a1028eec09efbc1c8d13293b7834..e987f48781523ee6b5ed689407231eec85f62868 100644 (file)
--- a/docs/modules.conf.example
+++ b/docs/modules.conf.example
@@ -1568,8 +1568,8 @@
 # showfromopers="yes">
 
 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
-# Shun module: Provides the /shun command, which stops a user executing 
-# most commands.
+# Shun module: Provides the /SHUN command, which stops a user from
+# executing all except configured commands.
 # This module is oper-only.
 # To use, SHUN must be in one of your oper class blocks.
 #<module name="m_shun.so">

diff --git a/src/modules/m_censor.cpp b/src/modules/m_censor.cpp
index 170fe8b07932d4d88591f1960d61dcd293a50b36..5e832cc8b6007e12c6197d91ebd97c45caefe355 100644 (file)
--- a/src/modules/m_censor.cpp
+++ b/src/modules/m_censor.cpp
@@ -20,6 +20,8 @@
  */
 
 
+/* $ModDesc: Provides user and channel +G mode */
+
 #define _CRT_SECURE_NO_DEPRECATE
 #define _SCL_SECURE_NO_DEPRECATE
 
@@ -28,8 +30,6 @@
 
 typedef std::map<irc::string,irc::string> censor_t;
 
-/* $ModDesc: Provides user and channel +G mode */
-
 /** Handles usermode +G
  */
 class CensorUser : public SimpleUserModeHandler

diff --git a/src/modules/m_chancreate.cpp b/src/modules/m_chancreate.cpp
index d7dfe8d2cc27c75cafaa718cb3429053fb43d253..48f60a8d91b91433ffe28a15cd57627ba8390994 100644 (file)
--- a/src/modules/m_chancreate.cpp
+++ b/src/modules/m_chancreate.cpp
@@ -21,7 +21,7 @@
 
 #include "inspircd.h"
 
-/* $ModDesc: Creates a snomask with notices whenever a new channel is created */
+/* $ModDesc: Provides snomasks 'j' and 'J', to which notices about newly created channels are sent */
 
 class ModuleChanCreate : public Module
 {
@@ -36,7 +36,7 @@ class ModuleChanCreate : public Module
 
        Version GetVersion()
        {
-               return Version("Creates a snomask with notices whenever a new channel is created",VF_VENDOR);
+               return Version("Provides snomasks 'j' and 'J', to which notices about newly created channels are sent",VF_VENDOR);
        }
 
 

diff --git a/src/modules/m_chanfilter.cpp b/src/modules/m_chanfilter.cpp
index e6585e524cc9d51050659789942eb1dada2e770f..c899d7a4b3b9b15865be7edba3907b8ac3f10195 100644 (file)
--- a/src/modules/m_chanfilter.cpp
+++ b/src/modules/m_chanfilter.cpp
@@ -23,14 +23,14 @@
  */
 
 
+/* $ModDesc: Provides channel-specific censor lists (like mode +G but varies from channel to channel) */
+
 #define _CRT_SECURE_NO_DEPRECATE
 #define _SCL_SECURE_NO_DEPRECATE
 
 #include "inspircd.h"
 #include "u_listmode.h"
 
-/* $ModDesc: Provides channel-specific censor lists (like mode +G but varies from channel to channel) */
-
 /** Handles channel mode +g
  */
 class ChanFilter : public ListModeBase

diff --git a/src/modules/m_check.cpp b/src/modules/m_check.cpp
index cabfd02bcfe782f2128f4ceb57b93427820e95b0..8316b09fe6275d9d5b53697189fc8f9f9aebe039 100644 (file)
--- a/src/modules/m_check.cpp
+++ b/src/modules/m_check.cpp
@@ -20,9 +20,9 @@
  */
 
 
-#include "inspircd.h"
+/* $ModDesc: Provides the /CHECK command to retrieve information on a user, channel, hostname or IP address */
 
-/* $ModDesc: Provides the /check command to retrieve information on a user, channel, or IP address */
+#include "inspircd.h"
 
 /** Handle /CHECK
  */
@@ -288,7 +288,7 @@ class ModuleCheck : public Module
 
        Version GetVersion()
        {
-               return Version("CHECK command, view user/channel details", VF_VENDOR|VF_OPTCOMMON);
+               return Version("CHECK command, view user, channel, IP address or hostname information", VF_VENDOR|VF_OPTCOMMON);
        }
 };
 

diff --git a/src/modules/m_clones.cpp b/src/modules/m_clones.cpp
index 1e5841609fa875f8f9a8c45450aabb8b8120067b..aceac0dc76ad061b807057c7ae3afaf28373813c 100644 (file)
--- a/src/modules/m_clones.cpp
+++ b/src/modules/m_clones.cpp
@@ -21,9 +21,9 @@
 
 #include "inspircd.h"
 
-/* $ModDesc: Provides the /clones command to retrieve information on clones. */
+/* $ModDesc: Provides the /CLONES command to retrieve information on clones. */
 
-/** Handle /CHECK
+/** Handle /CLONES
  */
 class CommandClones : public Command
 {
@@ -44,7 +44,7 @@ class CommandClones : public Command
                 * Syntax of a /clones reply:
                 *  :server.name 304 target :CLONES START
                 *  :server.name 304 target :CLONES <count> <ip>
-                *  :server.name 304 target :CHECK END
+                *  :server.name 304 target :CLONES END
                 */
 
                user->WriteServ(clonesstr + " START");
@@ -80,7 +80,7 @@ class ModuleClones : public Module
 
        virtual Version GetVersion()
        {
-               return Version("Provides the /clones command to retrieve information on clones.", VF_VENDOR);
+               return Version("Provides the /CLONES command to retrieve information on clones.", VF_VENDOR);
        }
 
 

diff --git a/src/modules/m_connectban.cpp b/src/modules/m_connectban.cpp
index f831a3b77b1ba50873c374efe77a065f29d8d1ed..00452a8f28c9e24c6689c01ab682ebcc06b36713 100644 (file)
--- a/src/modules/m_connectban.cpp
+++ b/src/modules/m_connectban.cpp
@@ -20,7 +20,7 @@
 #include "inspircd.h"
 #include "xline.h"
 
-/* $ModDesc: Throttles the connections of any users who try connect flood */
+/* $ModDesc: Throttles the connections of IP ranges who try to connect flood. */
 
 class ModuleConnectBan : public Module
 {
@@ -43,7 +43,7 @@ class ModuleConnectBan : public Module
 
        virtual Version GetVersion()
        {
-               return Version("Throttles the connections of any users who try connect flood", VF_VENDOR);
+               return Version("Throttles the connections of IP ranges who try to connect flood.", VF_VENDOR);
        }
 
        virtual void OnRehash(User* user)

diff --git a/src/modules/m_dccallow.cpp b/src/modules/m_dccallow.cpp
index 495a0da5a51fa92f88283a5ba628dd6d16a641f0..8c2a5f73e3e3e68c1167b33960631d39c8c8a83c 100644 (file)
--- a/src/modules/m_dccallow.cpp
+++ b/src/modules/m_dccallow.cpp
@@ -25,7 +25,7 @@
 
 #include "inspircd.h"
 
-/* $ModDesc: Povides support for the /DCCALLOW command */
+/* $ModDesc: Provides support for the /DCCALLOW command */
 
 class BannedFileList
 {
@@ -479,7 +479,7 @@ class ModuleDCCAllow : public Module
 
        virtual Version GetVersion()
        {
-               return Version("Povides support for the /DCCALLOW command", VF_COMMON | VF_VENDOR);
+               return Version("Provides support for the /DCCALLOW command", VF_COMMON | VF_VENDOR);
        }
 };
 

diff --git a/src/modules/m_delayjoin.cpp b/src/modules/m_delayjoin.cpp
index 3a574d485d07c7642828ee2a106c5cacc17237ff..34d782c7718eeb7ed243b812e3ad6223a79a7c84 100644 (file)
--- a/src/modules/m_delayjoin.cpp
+++ b/src/modules/m_delayjoin.cpp
@@ -20,6 +20,8 @@
  */
 
 
+/* $ModDesc: Allows for delay-join channels (+D) where users don't appear to join until they speak */
+
 #include "inspircd.h"
 #include <stdarg.h>
 
@@ -60,8 +62,6 @@ class ModuleDelayJoin : public Module
        ModResult OnRawMode(User* user, Channel* channel, const char mode, const std::string &param, bool adding, int pcnt);
 };
 
-/* $ModDesc: Allows for delay-join channels (+D) where users don't appear to join until they speak */
-
 ModeAction DelayJoinMode::OnModeChange(User* source, User* dest, Channel* channel, std::string &parameter, bool adding)
 {
        /* no change */
@@ -194,4 +194,3 @@ ModResult ModuleDelayJoin::OnRawMode(User* user, Channel* channel, const char mo
 }
 
 MODULE_INIT(ModuleDelayJoin)
-

diff --git a/src/modules/m_globops.cpp b/src/modules/m_globops.cpp
index 2ef6d61d8f69b0f1bf6b0f93c93133b71055f103..db55858d661565986d2b7a3bec8463b240bd5b02 100644 (file)
--- a/src/modules/m_globops.cpp
+++ b/src/modules/m_globops.cpp
@@ -19,11 +19,11 @@
  */
 
 
-// Globops and +g support module by C.J.Edwards
+// Globops and snomask +g module by C.J.Edwards
 
 #include "inspircd.h"
 
-/* $ModDesc: Provides support for GLOBOPS and user mode +g */
+/* $ModDesc: Provides support for GLOBOPS and snomask +g */
 
 /** Handle /GLOBOPS
  */
@@ -63,7 +63,7 @@ class ModuleGlobops : public Module
 
        virtual Version GetVersion()
        {
-               return Version("Provides support for GLOBOPS and user mode +g", VF_VENDOR);
+               return Version("Provides support for GLOBOPS and snomask +g", VF_VENDOR);
        }
 
 };

diff --git a/src/modules/m_halfop.cpp b/src/modules/m_halfop.cpp
index 2c4b086cb4f3f96f0ff8c76521a45a9de4ad1909..f0eda3e5698fa3a86b924bc02db0cce14cf5c53a 100644 (file)
--- a/src/modules/m_halfop.cpp
+++ b/src/modules/m_halfop.cpp
@@ -17,6 +17,8 @@
  */
 
 
+/* $ModDesc: Channel half-operator mode provider */
+
 #include "inspircd.h"
 
 class ModeChannelHalfOp : public ModeHandler

diff --git a/src/modules/m_helpop.cpp b/src/modules/m_helpop.cpp
index dd2e77986c09453e4d53f684e62fff2240f16ed6..a7bd4a8c56969addd51d5bb8b80c940c21186939 100644 (file)
--- a/src/modules/m_helpop.cpp
+++ b/src/modules/m_helpop.cpp
@@ -21,6 +21,8 @@
  */
 
 
+/* $ModDesc: Provides the /HELPOP command, works like UnrealIRCd's helpop */
+
 #include "inspircd.h"
 
 static std::map<irc::string, std::string> helpop_map;

diff --git a/src/modules/m_httpd_config.cpp b/src/modules/m_httpd_config.cpp
index aa84b83a48521f609a2203b73d650af080254d8f..0df1c12fb6355967c31b5736de35cae67db90a04 100644 (file)
--- a/src/modules/m_httpd_config.cpp
+++ b/src/modules/m_httpd_config.cpp
@@ -22,7 +22,7 @@
 #include "httpd.h"
 #include "protocol.h"
 
-/* $ModDesc: Provides statistics over HTTP via m_httpd.so */
+/* $ModDesc: Allows for the server configuration to be viewed over HTTP via m_httpd.so */
 
 class ModuleHttpConfig : public Module
 {
@@ -107,7 +107,7 @@ class ModuleHttpConfig : public Module
 
        virtual Version GetVersion()
        {
-               return Version("Provides configuration over HTTP via m_httpd.so", VF_VENDOR);
+               return Version("Allows for the server configuration to be viewed over HTTP via m_httpd.so", VF_VENDOR);
        }
 };
 

diff --git a/src/modules/m_jumpserver.cpp b/src/modules/m_jumpserver.cpp
index 4379f931a8cf9f9da63b240c6b99ea50512df789..9a171a19a3461e64cf36782e75335c19c19d7adb 100644 (file)
--- a/src/modules/m_jumpserver.cpp
+++ b/src/modules/m_jumpserver.cpp
@@ -21,7 +21,7 @@
 
 #include "inspircd.h"
 
-/* $ModDesc: Provides support for the RPL_REDIR numeric */
+/* $ModDesc: Provides support for the RPL_REDIR numeric and the /JUMPSERVER command. */
 
 /** Handle /JUMPSERVER
  */
@@ -174,7 +174,7 @@ class ModuleJumpServer : public Module
 
        virtual Version GetVersion()
        {
-               return Version("Provides support for the RPL_REDIR numeric", VF_VENDOR);
+               return Version("Provides support for the RPL_REDIR numeric and the /JUMPSERVER command.", VF_VENDOR);
        }
 
 };

diff --git a/src/modules/m_knock.cpp b/src/modules/m_knock.cpp
index 5664e79ab8f603a879530fda29ebfb5630ce5678..84838ec7f5f2bcfaa5c85775338035033503530f 100644 (file)
--- a/src/modules/m_knock.cpp
+++ b/src/modules/m_knock.cpp
@@ -21,7 +21,7 @@
 
 #include "inspircd.h"
 
-/* $ModDesc: Provides support for /KNOCK and mode +K */
+/* $ModDesc: Provides support for /KNOCK and channel mode +K */
 
 /** Handles the /KNOCK command
  */
@@ -109,7 +109,7 @@ class ModuleKnock : public Module
 
        virtual Version GetVersion()
        {
-               return Version("Provides support for /KNOCK and mode +K", VF_OPTCOMMON | VF_VENDOR);
+               return Version("Provides support for /KNOCK and channel mode +K", VF_OPTCOMMON | VF_VENDOR);
        }
 };
 

diff --git a/src/modules/m_mlock.cpp b/src/modules/m_mlock.cpp
index b5f34c93614fa644a17b1dd799ddfeeab77f70cc..e9ca3bfd0c0dc042f2a5b81466df755d977de252 100644 (file)
--- a/src/modules/m_mlock.cpp
+++ b/src/modules/m_mlock.cpp
@@ -16,6 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
+
+/* $ModDesc: Implements the ability to have server-side MLOCK enforcement. */
+
 #include "inspircd.h"
 
 class ModuleMLock : public Module

diff --git a/src/modules/m_namedmodes.cpp b/src/modules/m_namedmodes.cpp
index 8233f4357b061bf2b62ad42f45180670c57f3736..024cc427c4f4aaeb00ee6e99494ad7d9dd6107a9 100644 (file)
--- a/src/modules/m_namedmodes.cpp
+++ b/src/modules/m_namedmodes.cpp
@@ -17,6 +17,8 @@
  */
 
 
+/* $ModDesc: Provides the ability to manipulate modes via long names. */
+
 #include "inspircd.h"
 
 static void DisplayList(User* user, Channel* channel)

diff --git a/src/modules/m_operlevels.cpp b/src/modules/m_operlevels.cpp
index d142a4b0f6867d365694bb26141c80ea9f176691..da506dd582e0c164cc240a68e4b24d9b483fa318 100644 (file)
--- a/src/modules/m_operlevels.cpp
+++ b/src/modules/m_operlevels.cpp
@@ -20,9 +20,10 @@
  */
 
 
+/* $ModDesc: Gives each oper type a 'level', cannot kill opers 'above' your level. */
+
 #include "inspircd.h"
 
-/* $ModDesc: Gives each oper type a 'level', cannot kill opers 'above' your level. */
 class ModuleOperLevels : public Module
 {
        public:

diff --git a/src/modules/m_passforward.cpp b/src/modules/m_passforward.cpp
index 47f71bbe08f1b9ae050fac54e7f569332cb496b4..bf09c1f6e4a228dda9b0c6c2f1a1ad50008d6385 100644 (file)
--- a/src/modules/m_passforward.cpp
+++ b/src/modules/m_passforward.cpp
@@ -17,6 +17,8 @@
  */
 
 
+/* $ModDesc: Forwards a password users can send on connect (for example for NickServ identification). */
+
 #include "inspircd.h"
 
 class ModulePassForward : public Module
@@ -100,4 +102,3 @@ class ModulePassForward : public Module
 };
 
 MODULE_INIT(ModulePassForward)
-

diff --git a/src/modules/m_randquote.cpp b/src/modules/m_randquote.cpp
index 94cd3dbac775b244738df8308862e150b00b0b97..5fa63d8f4fad65bdca9d27b1c3734e669a1d787e 100644 (file)
--- a/src/modules/m_randquote.cpp
+++ b/src/modules/m_randquote.cpp
@@ -21,6 +21,8 @@
  */
 
 
+/* $ModDesc: Provides random quotes on connect. */
+
 #include "inspircd.h"
 
 static FileReader *quotes = NULL;
@@ -28,8 +30,6 @@ static FileReader *quotes = NULL;
 std::string prefix;
 std::string suffix;
 
-/* $ModDesc: Provides random Quotes on Connect. */
-
 /** Handle /RANDQUOTE
  */
 class CommandRandquote : public Command
@@ -88,7 +88,7 @@ class ModuleRandQuote : public Module
 
        virtual Version GetVersion()
        {
-               return Version("Provides random Quotes on Connect.",VF_VENDOR);
+               return Version("Provides random quotes on connect.",VF_VENDOR);
        }
 
        virtual void OnUserConnect(LocalUser* user)

diff --git a/src/modules/m_rline.cpp b/src/modules/m_rline.cpp
index 5ee3355df6253651bc6c1f998a40169d6b532ec3..06c852938b9f564101efdf5285a15af6882cc9b7 100644 (file)
--- a/src/modules/m_rline.cpp
+++ b/src/modules/m_rline.cpp
@@ -20,6 +20,8 @@
  */
 
 
+/* $ModDesc: RLINE: Regexp user banning. */
+
 #include "inspircd.h"
 #include "m_regex.h"
 #include "xline.h"
@@ -27,8 +29,6 @@
 static bool ZlineOnMatch = false;
 static std::vector<ZLine *> background_zlines;
 
-/* $ModDesc: RLINE: Regexp user banning. */
-
 class RLine : public XLine
 {
  public:
@@ -316,4 +316,3 @@ class ModuleRLine : public Module
 };
 
 MODULE_INIT(ModuleRLine)
-

diff --git a/src/modules/m_seenicks.cpp b/src/modules/m_seenicks.cpp
index 02c2621bbb9fc48d117838ba5a664bcee4d7c545..297504e05d7e147f5bd46e5690ca289c2e6cebdd 100644 (file)
--- a/src/modules/m_seenicks.cpp
+++ b/src/modules/m_seenicks.cpp
@@ -21,7 +21,7 @@
 
 #include "inspircd.h"
 
-/* $ModDesc: Provides support for seeing local and remote nickchanges via snomasks */
+/* $ModDesc: Provides support for seeing local and remote nickchanges via snomasks 'n' and 'N'. */
 
 class ModuleSeeNicks : public Module
 {

diff --git a/src/modules/m_services_account.cpp b/src/modules/m_services_account.cpp
index ef480269054b7a21a6db638376743c6ae7e8e8f3..7f3c5490719eb6e72bc57b54b98b33d4f4fc31d4 100644 (file)
--- a/src/modules/m_services_account.cpp
+++ b/src/modules/m_services_account.cpp
@@ -21,11 +21,11 @@
  */
 
 
+/* $ModDesc: Provides support for ircu-style services accounts, including chmode +R, etc. */
+
 #include "inspircd.h"
 #include "account.h"
 
-/* $ModDesc: Povides support for ircu-style services accounts, including chmode +R, etc. */
-
 /** Channel mode +r - mark a channel as identified
  */
 class Channel_r : public ModeHandler
@@ -289,7 +289,7 @@ class ModuleServicesAccount : public Module
 
        Version GetVersion()
        {
-               return Version("Povides support for ircu-style services accounts, including chmode +R, etc.",VF_OPTCOMMON|VF_VENDOR);
+               return Version("Provides support for ircu-style services accounts, including chmode +R, etc.",VF_OPTCOMMON|VF_VENDOR);
        }
 };
 

diff --git a/src/modules/m_shun.cpp b/src/modules/m_shun.cpp
index 5db3c8ef743cf2d01397dfe6d29c4c3e925be88f..391f9a187155d08cf05fe58da6456f02abced4d3 100644 (file)
--- a/src/modules/m_shun.cpp
+++ b/src/modules/m_shun.cpp
@@ -23,7 +23,7 @@
 #include "inspircd.h"
 #include "xline.h"
 
-/* $ModDesc: Provides the /shun command, which stops a user executing all commands except PING and PONG. */
+/* $ModDesc: Provides the /SHUN command, which stops a user from executing all except configured commands. */
 
 class Shun : public XLine
 {
@@ -308,7 +308,7 @@ class ModuleShun : public Module
 
        virtual Version GetVersion()
        {
-               return Version("Provides the /shun command, which stops a user executing all commands except PING and PONG.",VF_VENDOR|VF_COMMON);
+               return Version("Provides the /SHUN command, which stops a user from executing all except configured commands.",VF_VENDOR|VF_COMMON);
        }
 };