From 7ed7c7ba0dfd3f73a7d8a621988d7e99f07a23ef Mon Sep 17 00:00:00 2001
From: Sadie Powell
Date: Thu, 12 Mar 2026 15:15:38 +0000
Subject: Move <options:defaultmodes> to <channels> and rework.

- The default prefix modes are now separate from the default channel
  modes. This should result in less accidentally broken configs.

- The privs are now pre-parsed to a list of mode references. This
  should improve performance slightly as the repeated mode lookups
  are gone. It also allows us to write warnings to the debug log
  when the default privs are invalid.

- Channels can now have a default topic.
---
 docs/conf/inspircd.example.conf | 28 ++++++++++++++++++++--------
 1 file changed, 20 insertions(+), 8 deletions(-)

(limited to 'docs')

diff --git a/docs/conf/inspircd.example.conf b/docs/conf/inspircd.example.conf
index c61ab5f95..40bfa4271 100644
--- a/docs/conf/inspircd.example.conf
+++ b/docs/conf/inspircd.example.conf
@@ -585,6 +585,26 @@
           # triggers anti-takeover mechanisms of some obsolete bots.
           cyclehostsfromuser="no"
 
+          # defaultmodes: The modes to set on a channel when it is created. See
+          # https://docs.inspircd.org/4/channel-modes/ for a list of channel
+          # modes. All prefix modes should be included in the defaultprivs field
+          # below and will be ignored if specified here. The default value for
+          # this field sets channel modes n (noextmsg) and t (topiclock).
+          defaultmodes="nt"
+
+          # defaultprivs: The prefix modes to set on a channel creator. See
+          # https://docs.inspircd.org/4/channel-modes/ for a list of channel
+          # prefix modes. If a non-prefix mode is included in this option it
+          # will be ignored.
+          #
+          # The example below grants channel prefix mode o (op) to the channel
+          # creator.
+          #defaultprivs="o"
+
+          # defaulttopic: The topic to set on a channel when it is created. This
+          # does nothing by default.
+          #defaulttopic=""
+
           # exemptchanops: Allows users with with a status mode to be exempt
           # from various channel restrictions. Possible restrictions are:
           #  - anticaps        Channel mode +B - blocks messages with too many capital
@@ -694,14 +714,6 @@
          # 'splitmsg' - the same as split but also send a message explaining the split.
          splitwhois="no"
 
-         # defaultmodes: The modes to set on a channel when it is created. See
-         # https://docs.inspircd.org/4/channel-modes/ for a list of channel
-         # modes. If a prefix mode is included in this option it will be set on
-         # the user that created the channel. The example below sets channel
-         # modes n (noextmsg) and t (topiclock) and grants channel prefix mode
-         # o (op) to the channel creator.
-         defaultmodes="not"
-
          # xlinemessage: This is the text that is sent to a user when they are
          # banned from the server.
          xlinemessage="You're banned! Email irc@&networkDomain; with the ERROR line below for help."
-- 
cgit v1.3.1-10-gc9f91