Make wording for persistence options more clear in docs

This commit is contained in:
Mike Wilson
2025-10-16 15:57:34 -04:00
parent 0077d683a8
commit d1d35f2f04
2 changed files with 12 additions and 13 deletions
+5 -7
View File
@@ -147,18 +147,16 @@ any other IRC server.
persistent_by_default persistent_by_default
~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~
If this option is set to `true`, all rooms will be persistent by default: If this option is set to "true", all rooms will be persistent by default:
the value of the “persistent” option in the global configuration of each the value of the “persistent” option in the global configuration of each
user will be “true”, but the value of each individual room will still user will be “true”, but the value of each individual room will still
default to false. This means that a user just needs to change the global default to "false". This means that a user just needs to change their global
“persistent” configuration option to false in order to override this. “persistent” configuration option to "false" in order to override this
and be able to set rooms to not persistent.
If it is set to false (the default value), all rooms are not persistent by If this option is set to "false" (the default value), all rooms are not persistent by
default. default.
Each room can be configured individually by each user, to override this
default value. See :ref:`Ad-hoc commands`.
realname_customization realname_customization
~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~
+7 -6
View File
@@ -399,12 +399,13 @@ The provided configuration form contains these fields:
the database. the database.
- **Max history length**: The maximum number of lines in the history that - **Max history length**: The maximum number of lines in the history that
the server is allowed to send when joining a channel. the server is allowed to send when joining a channel.
- **Persistent**: Overrides the value specified in each individual - **Persistent**: If this option is set to true, the persistence setting
channel. If this option is set to true, all channels are persistent, specified on each individual channel is ignored and all channels are persistent.
whether or not their specific value is true or false. This option is true If this option is set to false, the persistence setting specified on each
by default for everyone if the `persistent_by_default` configuration individual channel is respected.
option is true, otherwise it’s false. See below for more details on what a This option defaults to the value of :ref:`persistent_by_default`, which itself
persistent channel is. defaults to false.
See below for more details on what a persistent channel is.
On a server JID On a server JID
~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~