Update refrence.conf's explanation of invex/except with warnings about disabling...

[irc/rqf/shadowircd.git] / doc / reference.conf

diff --git a/doc/reference.conf b/doc/reference.conf
index e019e39d0586cc6a80cf2752836bde256ef0c274..8764ddb5ac3a393598006bde611b29dd113485b1 100755 (executable)
--- a/doc/reference.conf
+++ b/doc/reference.conf
@@ -64,12 +64,18 @@
  * New host mangling (umode +x)                      -- ip_cloaking.so
  * Find channel forwards                             -- m_findforwards.so
  * /identify support                                 -- m_identify.so
+ * /mkpassword support                               -- m_mkpasswd.so
+ * Send message to all admins network-wide           -- m_adminwall.so
+ * /opme - op self in opless channels, admin only    -- m_opme.so
+ * /ojoin - join despite restrictions, admin only    -- m_ojoin.so
+ * /omode - force modes in channels, admin only      -- m_omode.so
+ * /olist - see all channels in /list, oper only     -- m_olist.so
+ * /forcejoin - force join users, admin only         -- m_force.so
  * Opers cannot be invisible (umode +i)              -- no_oper_invis.so
  * Far connection notices (snomask +F)               -- sno_farconnect.so
  * Remote k/d/x line active notices                  -- sno_globalkline.so
  * Remote oper up notices                            -- sno_globaloper.so
  * /whois notifications (snomask +W)                 -- sno_whois.so
- * Force join users to channels                      -- m_force.so
  */
 #loadmodule "extensions/chm_adminonly.so";
 loadmodule "extensions/chm_operonly.so";
@@ -90,12 +96,19 @@ loadmodule "extensions/extb_realname.so";
 loadmodule "extensions/ip_cloaking.so";
 #loadmodule "extensions/m_findforwards.so";
 loadmodule "extensions/m_identify.so";
+loadmodule "extensions/m_mkpasswd.so";
+#loadmodule "extensions/m_adminwall.so";
+#loadmodule "extensions/m_opme.so";
+#loadmodule "extensions/m_ojoin.so";
+#loadmodule "extensions/m_omode.so";
+#loadmodule "extensions/m_olist.so";
+#loadmodule "extensions/m_force.so";
 #loadmodule "extensions/no_oper_invis.so";
 loadmodule "extensions/sno_farconnect.so";
 loadmodule "extensions/sno_globalkline.so";
 loadmodule "extensions/sno_globaloper.so";
 #loadmodule "extensions/sno_whois.so";
-#loadmodule "extensions/m_force.so";
+
  
 /* serverinfo {}:  Contains information about the server. (OLD M:) */
 serverinfo {
@@ -681,24 +694,36 @@ channel {
        /* halfop: Enable/disable channel mode +h, which adds halfop,
         * a channel status below op that has op powers (kick, ban, mode, etc.)
         * halfops can only kick/devoice/etc people who are +v or
-        * do not have any channel status.
+        * do not have any channel status. Disabling this via rehash will
+        * cause things which are rather confusing to occur, it is highly
+        * recommended to restart if you wish to disable this option, though
+        * it may be enabled by rehash with no problems.
         */
        use_halfop = yes;
 
        /* owner: Enable/disable channel mode +a, which adds owner,
         * a channel status above op that has op powers (kick, ban, mode, etc.)
         * owners can only be kicked/deownered by other owners, and may kick
-        * or deop ops and halfops.
+        * or deop ops and halfops. Disabling this via rehash will
+        * cause things which are rather confusing to occur, it is highly
+        * recommended to restart if you wish to disable this option, though
+        * it may be enabled by rehash with no problems.
         */
        use_owner = yes;
 
        /* invex: Enable/disable channel mode +I, a n!u@h list of masks
-        * that can join a +i channel without an invite.
+        * that can join a +i channel without an invite. Disabling this option
+        * via rehash will leave all previously set invexes hanging around,
+        * though they will not do anything. For this reason, you may want to
+        * restart to disable this option.
         */
        use_invex = yes;
 
        /* except: Enable/disable channel mode +e, a n!u@h list of masks
-        * that can join a channel through a ban (+b).
+        * that can join a channel through a ban (+b). Disabling this option
+        * via rehash will leave all previously set excepts hanging around,
+        * though they will not do anything. For this reason, you may want to
+        * restart to disable this option.
         */
        use_except = yes;