X-Git-Url: https://jfr.im/git/irc/rqf/shadowircd.git/blobdiff_plain/307328bb13d557f8877d7b8cdc81c7a3c8d92108..143b6cc1e4a8faa8181301bf43ddafecab3237cc:/doc/sgml/oper-guide/cmodes.sgml

diff --git a/doc/sgml/oper-guide/cmodes.sgml b/doc/sgml/oper-guide/cmodes.sgml
index c56a1be..8d2306a 100644
--- a/doc/sgml/oper-guide/cmodes.sgml
+++ b/doc/sgml/oper-guide/cmodes.sgml
@@ -57,6 +57,12 @@
 	  This mode takes one parameter of the same form as bans, which
 	  overrides +b and +q bans for all clients it matches.
 	</para>
+	<para>
+	  This can be useful if it is necessary to ban an entire ISP
+	  due to persistent abuse, but some users from that ISP should
+	  still be allowed in. For example:
+	  /mode #channel +be *!*@*.example.com *!*someuser@host3.example.com
+	</para>
 	<para>
 	  Only channel operators can see +e changes or request the list.
 	</para>
@@ -98,7 +104,7 @@
 	  is unset, only channel operators may use the INVITE command.
 	</para>
 	<para>
-	  When this mode is set together with +i, all channel members can influence who can join.
+	  When this mode is set together with +i, +j, +l or +r, all channel members can influence who can join.
 	</para>
       </sect2>
       <sect2>
@@ -113,6 +119,7 @@
 	<para>
 	  This mode takes one parameter of the same form as bans. Matching
 	  clients do not need to be invited to join the channel when it is invite-only (+i).
+	  Unlike the INVITE command, this does not override +j, +l and +r.
 	</para>
 	<para>
 	  Only channel operators can see +I changes or request the list.
@@ -123,6 +130,9 @@
         <para>
           This mode takes one parameter of the form <replaceable>n</replaceable>:<replaceable>t</replaceable>, where <replaceable>n</replaceable> and <replaceable>t</replaceable> are positive integers. Only <replaceable>n</replaceable> users may join in each period of <replaceable>t</replaceable> seconds.
         </para>
+	<para>
+	  Invited users can join regardless of +j, but are counted as normal.
+	</para>
 	<para>
 	  Due to propagation delays between servers, more users may be
 	  able to join (by racing for the last slot on each server).
@@ -140,6 +150,7 @@
 	<para>
 	  Takes one numeric parameter, the number of users which are allowed to be in the channel before
 	  further joins are blocked.
+	  Invited users may join regardless.
 	</para>
 	<para>
 	  Due to propagation delays between servers, more users may be
@@ -151,7 +162,7 @@
 	<para>
 	  Channels with this mode will be allowed larger banlists (by default,
           500 instead of 50 entries for +b, +q, +e and +I together).
-	  Only network operators may set this mode.
+	  Only network operators with resv privilege may set this mode.
 	</para>
       </sect2>
       <sect2>
@@ -205,7 +216,7 @@
       <sect2>
 	<title>+P, permanent channel</title>
 	<para>
-	  Channels with this mode (which is accessible only to network operators) set will not be destroyed
+	  Channels with this mode (which is accessible only to network operators with resv privilege) set will not be destroyed
 	  when the last user leaves.
 	</para>
 	<para>
@@ -237,6 +248,7 @@
         <title>+r, block unidentified</title>
         <para>
           When set, this mode prevents unidentified users from joining.
+	  Invited users can still join.
         </para>
       </sect2>
       <!-- not planned (jilles)