Add comments

git-svn-id: http://svn.inspircd.org/repository/trunk/inspircd@7374 e03df62e-2008-0410-955e-edbf42e46eb7

55 files changed, 220 insertions, 55 deletions

diff --git a/include/commands/cmd_admin.h b/include/commands/cmd_admin.h
index ea919ab98..3a8b2c68c 100644
--- a/include/commands/cmd_admin.h
+++ b/include/commands/cmd_admin.h
@@ -21,7 +21,10 @@
 #include "channels.h"
 #include "ctables.h"
 
-/** Handle /ADMIN
+/** Handle /ADMIN. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_admin : public command_t
 {
diff --git a/include/commands/cmd_away.h b/include/commands/cmd_away.h
index b2ff1ad40..2063593c1 100644
--- a/include/commands/cmd_away.h
+++ b/include/commands/cmd_away.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /AWAY
+/** Handle /AWAY. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_away : public command_t
 {
diff --git a/include/commands/cmd_clearcache.h b/include/commands/cmd_clearcache.h
index 9af8fcb39..750e0ea86 100644
--- a/include/commands/cmd_clearcache.h
+++ b/include/commands/cmd_clearcache.h
@@ -21,7 +21,10 @@
 #include "channels.h"
 #include "ctables.h"
 
-/** Handle /ADMIN
+/** Handle /ADMIN. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_clearcache : public command_t
 {
diff --git a/include/commands/cmd_commands.h b/include/commands/cmd_commands.h
index 217a8caaf..defdeeafc 100644
--- a/include/commands/cmd_commands.h
+++ b/include/commands/cmd_commands.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /COMMANDS
+/** Handle /COMMANDS. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_commands : public command_t
 {
diff --git a/include/commands/cmd_connect.h b/include/commands/cmd_connect.h
index 0233b4f9d..113d25962 100644
--- a/include/commands/cmd_connect.h
+++ b/include/commands/cmd_connect.h
@@ -22,7 +22,10 @@
 #include "ctables.h"
 #include "modules.h"
 
-/** Handle /CONNECT
+/** Handle /CONNECT. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_connect : public command_t
 {
diff --git a/include/commands/cmd_die.h b/include/commands/cmd_die.h
index 7e19dd7df..0db044944 100644
--- a/include/commands/cmd_die.h
+++ b/include/commands/cmd_die.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /DIE
+/** Handle /DIE. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_die : public command_t
 {
diff --git a/include/commands/cmd_eline.h b/include/commands/cmd_eline.h
index c53bd7816..749816ea0 100644
--- a/include/commands/cmd_eline.h
+++ b/include/commands/cmd_eline.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /ELINE
+/** Handle /ELINE. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_eline : public command_t
 {
diff --git a/include/commands/cmd_gline.h b/include/commands/cmd_gline.h
index 816ff6ae4..f4c0f4035 100644
--- a/include/commands/cmd_gline.h
+++ b/include/commands/cmd_gline.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /GLINE
+/** Handle /GLINE. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_gline : public command_t
 {
diff --git a/include/commands/cmd_info.h b/include/commands/cmd_info.h
index 974c44136..b7bce15cf 100644
--- a/include/commands/cmd_info.h
+++ b/include/commands/cmd_info.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /INFO
+/** Handle /INFO. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_info : public command_t
 {
diff --git a/include/commands/cmd_invite.h b/include/commands/cmd_invite.h
index 749aa5023..74848915f 100644
--- a/include/commands/cmd_invite.h
+++ b/include/commands/cmd_invite.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /INVITE
+/** Handle /INVITE. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_invite : public command_t
 {
diff --git a/include/commands/cmd_ison.h b/include/commands/cmd_ison.h
index 7061a9ab9..52624b2c2 100644
--- a/include/commands/cmd_ison.h
+++ b/include/commands/cmd_ison.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /ISON
+/** Handle /ISON. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_ison : public command_t
 {
diff --git a/include/commands/cmd_join.h b/include/commands/cmd_join.h
index 79a9b7fae..eb17034b0 100644
--- a/include/commands/cmd_join.h
+++ b/include/commands/cmd_join.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /JOIN
+/** Handle /JOIN. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_join : public command_t
 {
diff --git a/include/commands/cmd_kick.h b/include/commands/cmd_kick.h
index 312944cde..6cb2148a5 100644
--- a/include/commands/cmd_kick.h
+++ b/include/commands/cmd_kick.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /KICK
+/** Handle /KICK. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_kick : public command_t
 {
diff --git a/include/commands/cmd_kill.h b/include/commands/cmd_kill.h
index 8558e50b3..dbec15e6e 100644
--- a/include/commands/cmd_kill.h
+++ b/include/commands/cmd_kill.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /KILL
+/** Handle /KILL. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_kill : public command_t
 {
diff --git a/include/commands/cmd_kline.h b/include/commands/cmd_kline.h
index f38d9e6bb..29e7d8395 100644
--- a/include/commands/cmd_kline.h
+++ b/include/commands/cmd_kline.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /KLINE
+/** Handle /KLINE. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_kline : public command_t
 {
diff --git a/include/commands/cmd_links.h b/include/commands/cmd_links.h
index fa4970196..bcf04ab0a 100644
--- a/include/commands/cmd_links.h
+++ b/include/commands/cmd_links.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /LINKS
+/** Handle /LINKS. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_links : public command_t
 {
diff --git a/include/commands/cmd_list.h b/include/commands/cmd_list.h
index 254cfe34e..1016db1b4 100644
--- a/include/commands/cmd_list.h
+++ b/include/commands/cmd_list.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /LIST
+/** Handle /LIST. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_list : public command_t
 {
diff --git a/include/commands/cmd_loadmodule.h b/include/commands/cmd_loadmodule.h
index bbdeebfee..ced357844 100644
--- a/include/commands/cmd_loadmodule.h
+++ b/include/commands/cmd_loadmodule.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /LOADMODULE
+/** Handle /LOADMODULE. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_loadmodule : public command_t
 {
diff --git a/include/commands/cmd_lusers.h b/include/commands/cmd_lusers.h
index c639263af..38e309a8f 100644
--- a/include/commands/cmd_lusers.h
+++ b/include/commands/cmd_lusers.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /LUSERS
+/** Handle /LUSERS. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_lusers : public command_t
 {
diff --git a/include/commands/cmd_map.h b/include/commands/cmd_map.h
index 76e98be72..2514a026b 100644
--- a/include/commands/cmd_map.h
+++ b/include/commands/cmd_map.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /MAP
+/** Handle /MAP. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_map : public command_t
 {
diff --git a/include/commands/cmd_mode.h b/include/commands/cmd_mode.h
index a33301a34..90655d871 100644
--- a/include/commands/cmd_mode.h
+++ b/include/commands/cmd_mode.h
@@ -21,7 +21,10 @@
 #include "channels.h"
 #include "ctables.h"
 
-/** Handle /MODE
+/** Handle /MODE. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_mode : public command_t
 {
diff --git a/include/commands/cmd_modules.h b/include/commands/cmd_modules.h
index a05e7d599..a4945810e 100644
--- a/include/commands/cmd_modules.h
+++ b/include/commands/cmd_modules.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /MODULES
+/** Handle /MODULES. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_modules : public command_t
 {
diff --git a/include/commands/cmd_motd.h b/include/commands/cmd_motd.h
index 44e033970..05b5b3b85 100644
--- a/include/commands/cmd_motd.h
+++ b/include/commands/cmd_motd.h
@@ -25,7 +25,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /MOTD
+/** Handle /MOTD. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_motd : public command_t
 {
diff --git a/include/commands/cmd_names.h b/include/commands/cmd_names.h
index d6ce1280c..7b898923b 100644
--- a/include/commands/cmd_names.h
+++ b/include/commands/cmd_names.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /NAMES
+/** Handle /NAMES. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_names : public command_t
 {
diff --git a/include/commands/cmd_nick.h b/include/commands/cmd_nick.h
index a2682a371..a1e1513f2 100644
--- a/include/commands/cmd_nick.h
+++ b/include/commands/cmd_nick.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /NICK
+/** Handle /NICK. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_nick : public command_t
 {
diff --git a/include/commands/cmd_notice.h b/include/commands/cmd_notice.h
index cb2acdf19..72fd070fb 100644
--- a/include/commands/cmd_notice.h
+++ b/include/commands/cmd_notice.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /NOTICE
+/** Handle /NOTICE. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_notice : public command_t
 {
diff --git a/include/commands/cmd_oper.h b/include/commands/cmd_oper.h
index 9a06a0922..405019fbc 100644
--- a/include/commands/cmd_oper.h
+++ b/include/commands/cmd_oper.h
@@ -24,7 +24,10 @@
 
 bool OneOfMatches(const char* host, const char* ip, const char* hostlist);
 
-/** Handle /OPER
+/** Handle /OPER. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_oper : public command_t
 {
diff --git a/include/commands/cmd_part.h b/include/commands/cmd_part.h
index 0130d0a4f..442d90503 100644
--- a/include/commands/cmd_part.h
+++ b/include/commands/cmd_part.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /PART
+/** Handle /PART. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_part : public command_t
 {
diff --git a/include/commands/cmd_pass.h b/include/commands/cmd_pass.h
index b6dbbac21..53900685b 100644
--- a/include/commands/cmd_pass.h
+++ b/include/commands/cmd_pass.h
@@ -25,7 +25,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /PASS
+/** Handle /PASS. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_pass : public command_t
 {
diff --git a/include/commands/cmd_ping.h b/include/commands/cmd_ping.h
index 2e733829b..7b22c35bb 100644
--- a/include/commands/cmd_ping.h
+++ b/include/commands/cmd_ping.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /PING
+/** Handle /PING. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_ping : public command_t
 {
diff --git a/include/commands/cmd_pong.h b/include/commands/cmd_pong.h
index 8329072f9..6f0a2c7d2 100644
--- a/include/commands/cmd_pong.h
+++ b/include/commands/cmd_pong.h
@@ -23,7 +23,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /PONG
+/** Handle /PONG. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_pong : public command_t
 {
diff --git a/include/commands/cmd_privmsg.h b/include/commands/cmd_privmsg.h
index 76bdb331e..2d720cf7f 100644
--- a/include/commands/cmd_privmsg.h
+++ b/include/commands/cmd_privmsg.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /PRIVMSG
+/** Handle /PRIVMSG. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_privmsg : public command_t
 {
diff --git a/include/commands/cmd_qline.h b/include/commands/cmd_qline.h
index 816f599a2..7f7e0924a 100644
--- a/include/commands/cmd_qline.h
+++ b/include/commands/cmd_qline.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /QLINE
+/** Handle /QLINE. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_qline : public command_t
 {
diff --git a/include/commands/cmd_quit.h b/include/commands/cmd_quit.h
index c9813757f..ba8a165f1 100644
--- a/include/commands/cmd_quit.h
+++ b/include/commands/cmd_quit.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /QUIT
+/** Handle /QUIT. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_quit : public command_t
 {
diff --git a/include/commands/cmd_rehash.h b/include/commands/cmd_rehash.h
index 9f85fe26b..85b09649a 100644
--- a/include/commands/cmd_rehash.h
+++ b/include/commands/cmd_rehash.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /REHASH
+/** Handle /REHASH. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_rehash : public command_t
 {
diff --git a/include/commands/cmd_reloadmodule.h b/include/commands/cmd_reloadmodule.h
index c4e62c552..9825d853a 100644
--- a/include/commands/cmd_reloadmodule.h
+++ b/include/commands/cmd_reloadmodule.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /RELOADMODULE
+/** Handle /RELOADMODULE. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_reloadmodule : public command_t
 {
diff --git a/include/commands/cmd_restart.h b/include/commands/cmd_restart.h
index 2622bd5dc..704d2822c 100644
--- a/include/commands/cmd_restart.h
+++ b/include/commands/cmd_restart.h
@@ -25,7 +25,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /RESTART
+/** Handle /RESTART. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_restart : public command_t
 {
diff --git a/include/commands/cmd_rules.h b/include/commands/cmd_rules.h
index fbdd4a10e..333f39711 100644
--- a/include/commands/cmd_rules.h
+++ b/include/commands/cmd_rules.h
@@ -25,7 +25,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /RULES
+/** Handle /RULES. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_rules : public command_t
 {
diff --git a/include/commands/cmd_server.h b/include/commands/cmd_server.h
index be458defd..01b1f0810 100644
--- a/include/commands/cmd_server.h
+++ b/include/commands/cmd_server.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /SERVER
+/** Handle /SERVER. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_server : public command_t
 {
diff --git a/include/commands/cmd_squit.h b/include/commands/cmd_squit.h
index 0f4201276..299b37558 100644
--- a/include/commands/cmd_squit.h
+++ b/include/commands/cmd_squit.h
@@ -25,7 +25,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /SQUIT
+/** Handle /SQUIT. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_squit : public command_t
 {
diff --git a/include/commands/cmd_stats.h b/include/commands/cmd_stats.h
index e004a1fd6..6d4082a5a 100644
--- a/include/commands/cmd_stats.h
+++ b/include/commands/cmd_stats.h
@@ -25,7 +25,10 @@
 
 DllExport void DoStats(InspIRCd* Instance, char statschar, userrec* user, string_list &results);
 
-/** Handle /STATS
+/** Handle /STATS. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_stats : public command_t
 {
diff --git a/include/commands/cmd_summon.h b/include/commands/cmd_summon.h
index 6804694f0..d973df556 100644
--- a/include/commands/cmd_summon.h
+++ b/include/commands/cmd_summon.h
@@ -25,7 +25,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /SUMMON stub
+/** Handle /SUMMON stub. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_summon : public command_t
 {
diff --git a/include/commands/cmd_time.h b/include/commands/cmd_time.h
index b84b853db..e54f7d2c4 100644
--- a/include/commands/cmd_time.h
+++ b/include/commands/cmd_time.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /TIME
+/** Handle /TIME. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_time : public command_t
 {
diff --git a/include/commands/cmd_topic.h b/include/commands/cmd_topic.h
index 00edcadf6..009b2e2d7 100644
--- a/include/commands/cmd_topic.h
+++ b/include/commands/cmd_topic.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /TOPIC
+/** Handle /TOPIC. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_topic : public command_t
 {
diff --git a/include/commands/cmd_trace.h b/include/commands/cmd_trace.h
index bb91f7293..33a9114e6 100644
--- a/include/commands/cmd_trace.h
+++ b/include/commands/cmd_trace.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /TRACE
+/** Handle /TRACE. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_trace : public command_t
 {
diff --git a/include/commands/cmd_unloadmodule.h b/include/commands/cmd_unloadmodule.h
index cc16f313d..457d25853 100644
--- a/include/commands/cmd_unloadmodule.h
+++ b/include/commands/cmd_unloadmodule.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /UNLOADMODULE
+/** Handle /UNLOADMODULE. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_unloadmodule : public command_t
 {
diff --git a/include/commands/cmd_user.h b/include/commands/cmd_user.h
index 44dfa483f..b416225d5 100644
--- a/include/commands/cmd_user.h
+++ b/include/commands/cmd_user.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /USER
+/** Handle /USER. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_user : public command_t
 {
diff --git a/include/commands/cmd_userhost.h b/include/commands/cmd_userhost.h
index 7f46f85f3..980a464b8 100644
--- a/include/commands/cmd_userhost.h
+++ b/include/commands/cmd_userhost.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /USERHOST
+/** Handle /USERHOST. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_userhost : public command_t
 {
diff --git a/include/commands/cmd_users.h b/include/commands/cmd_users.h
index 78d44429f..4bcd27017 100644
--- a/include/commands/cmd_users.h
+++ b/include/commands/cmd_users.h
@@ -25,7 +25,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /USERS stub
+/** Handle /USERS stub. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_users : public command_t
 {
diff --git a/include/commands/cmd_version.h b/include/commands/cmd_version.h
index 42ac968ea..82f8cb5a4 100644
--- a/include/commands/cmd_version.h
+++ b/include/commands/cmd_version.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /VERSION
+/** Handle /VERSION. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_version : public command_t
 {
diff --git a/include/commands/cmd_wallops.h b/include/commands/cmd_wallops.h
index 775e1c116..f5344e1df 100644
--- a/include/commands/cmd_wallops.h
+++ b/include/commands/cmd_wallops.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /WALLOPS
+/** Handle /WALLOPS. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_wallops : public command_t
 {
diff --git a/include/commands/cmd_who.h b/include/commands/cmd_who.h
index 88e6fdc15..3d4807b3b 100644
--- a/include/commands/cmd_who.h
+++ b/include/commands/cmd_who.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /WHO
+/** Handle /WHO. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_who : public command_t
 {
diff --git a/include/commands/cmd_whois.h b/include/commands/cmd_whois.h
index af8228c74..f929728b3 100644
--- a/include/commands/cmd_whois.h
+++ b/include/commands/cmd_whois.h
@@ -25,7 +25,10 @@
 const char* Spacify(char* n);
 DllExport void do_whois(InspIRCd* Instance, userrec* user, userrec* dest,unsigned long signon, unsigned long idle, const char* nick);
 
-/** Handle /WHOIS
+/** Handle /WHOIS. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_whois : public command_t
 {
diff --git a/include/commands/cmd_whowas.h b/include/commands/cmd_whowas.h
index e2bab7a0f..c3e00c6de 100644
--- a/include/commands/cmd_whowas.h
+++ b/include/commands/cmd_whowas.h
@@ -54,7 +54,10 @@ typedef std::map<irc::string,whowas_set*> whowas_users;
  */
 typedef std::deque<std::pair<time_t,irc::string> > whowas_users_fifo;
 
-/** Handle /WHOWAS
+/** Handle /WHOWAS. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_whowas : public command_t
 {
diff --git a/include/commands/cmd_zline.h b/include/commands/cmd_zline.h
index 122fc165a..54ce1a9c1 100644
--- a/include/commands/cmd_zline.h
+++ b/include/commands/cmd_zline.h
@@ -22,7 +22,10 @@
 #include "users.h"
 #include "channels.h"
 
-/** Handle /ZLINE
+/** Handle /ZLINE. These command handlers can be reloaded by the core,
+ * and handle basic RFC1459 commands. Commands within modules work
+ * the same way, however, they can be fully unloaded, where these
+ * may not.
  */
 class cmd_zline : public command_t
 {