Document the migration path for removed config options.

Also resort the config changelog so it is listed alphabetically.

1 files changed, 18 insertions, 19 deletions

diff --git a/docs/Changes.conf b/docs/Changes.conf
index b41d199de..f3b2bb2b4 100644
--- a/docs/Changes.conf
+++ b/docs/Changes.conf
@@ -8,9 +8,9 @@ Added {nickserv}:minprotect (defaults to 10s)
 Added {xmlrpc}:enable_i8 (defaults to yes).
 Added {xmlrpc}:enable_nil (defaults to yes).
 Changed the syntax for using defines (all existing defines will need to be updated).
-Removed {nickserv}:kill.
-Removed {nickserv}:killquick.
-Removed {ns_set_kill}:allowkillimmed.
+Removed {nickserv}:kill (replaced by custom protection timer durations).
+Removed {nickserv}:killquick (replaced by custom protection timer durations).
+Removed {ns_set_kill}:allowkillimmed (replaced by custom protection timer durations).
 Renamed the nickserv/saset/kill command to nickserv/saset/protect.
 Renamed the nickserv/saset/kill oper privilege to nickserv/saset/protect.
 Renamed the nickserv/set/kill command to nickserv/set/protect.
@@ -30,16 +30,16 @@ Renamed the xmlrpc_main module to rpc_main.
 
 Anope Version 2.1.11
 --------------------
-Moved {ns_set}:allowkillimmed to {ns_set_kill}:allowkillimmed.
 Moved nickserv/set/kill and nickserv/saset/kill to the ns_set_kill module.
+Moved {ns_set}:allowkillimmed to {ns_set_kill}:allowkillimmed.
 Replaced {nickserv}:guestnickprefix with {nickserv}:guestnick (defaults to Guest####).
 
 Anope Version 2.1.10
 --------------------
 Added options:servicealias (defaults to no)
 Moved nickserv/set/message and nickserv/saset/message to the ns_set_message module.
-Removed options:useprivmsg.
-Removed options:usestrictprivmsg.
+Removed options:useprivmsg (replaced by loading the ns_set_message module to enable).
+Removed options:usestrictprivmsg (feature unusable on modern servers, consider migrating to options:servicealias instead).
 
 Anope Version 2.1.9
 -------------------
@@ -47,14 +47,14 @@ No significant changes.
 
 Anope Version 2.1.8
 -------------------
-Added {nickserv}:preservedisplay (defaults to no).
 Added the nickserv/drop/display oper privilege.
+Added {nickserv}:preservedisplay (defaults to no).
 
 Anope Version 2.1.7
 -------------------
 Moved nickserv/set/language and nickserv/saset/language to the ns_set_language module.
-Renamed {cs_suspend}:expire to {cs_suspend}:suspendexpire.
 Renamed the FANTASIA channel privilege to FANTASY.
+Renamed {cs_suspend}:expire to {cs_suspend}:suspendexpire.
 
 Anope Version 2.1.6
 -------------------
@@ -83,10 +83,9 @@ Changed the default value of {chanserv}:accessmax to 1000.
 Changed the default value of {chanserv}:inhabit to 1 minute.
 Changed the default value of {cs_mode}:max to 50.
 Changed the default value of {ms_ignore}:max to 50.
-Removed options:seed.
+Removed options:seed (not needed with modern random number generation).
 Replaced {webcpanel}:template with {webcpanel}:template_dir (defaults to webcpanel/templates/default).
 
-
 Anope Version 2.1.3
 -------------------
 Added options:didyoumeandifference (defaults to 4).
@@ -99,21 +98,21 @@ Changed networkinfo:nicklen to default to 31 if not set.
 Changed networkinfo:userlen to default to 10 if not set.
 Increased the default maximum password length to 50 characters.
 Increased the default minimum password length to 10 characters.
-Removed the cs_secure option in {chanserv}:defaults (now always enabled).
-Removed the nickserv/saset/secure command.
-Removed the nickserv/saset/secure oper privilege.
-Removed the nickserv/set/secure command.
-Removed the nickserv/status command.
-Removed the ns_access module.
-Removed the ns_secure option in {nickserv}:defaults (now always enabled).
+Removed the cs_secure option in {chanserv}:defaults (now always enabled as support for nick access lists has been removed).
+Removed the nickserv/saset/secure command (support for nick access lists has been removed).
+Removed the nickserv/saset/secure oper privilege (support for nick access lists has been removed).
+Removed the nickserv/set/secure command (support for nick access lists has been removed).
+Removed the nickserv/status command (obsolete with modern IRCv3 extensions and the removal of nick access lists).
+Removed the ns_access module (support for nick access lists has been removed).
+Removed the ns_secure option in {nickserv}:defaults (now always enabled as support for nick access lists has been removed).
 
 Anope Version 2.1.2
 -------------------
 Added {ssl_openssl}:tlsv10 for configuring whether TLSv1.0 is usable (defaults to no).
 Added {ssl_openssl}:tlsv11 for configuring whether TLSv1.1 is usable (defaults to yes).
 Added {ssl_openssl}:tlsv12 for configuring whether TLSv1.2 is usable (defaults to yes).
-Removed {ssl_openssl}:sslv3 (now always disabled).
 Removed the m_ prefix from the names of the chanstats, dns, dnsbl, helpchan, httpd, ldap, ldap_oper, mysql, proxyscan, redis, regex_pcre2, regex_posix, regex_stdlib, regex_tre, rewrite, sasl, sql_log, sql_oper, sqlite, ssl_gnutls, ssl_openssl, xmlrpc, and xmlrpc_main modules.
+Removed {ssl_openssl}:sslv3 (now always disabled).
 
 Anope Version 2.1.1
 -------------------
@@ -123,7 +122,7 @@ Removed the m_regex_pcre module (use m_regex_pcre2 instead).
 Anope Version 2.1.0
 -------------------
 Added nickserv:minpasslen for configuring the minimum password length (defaults to 8).
-Removed nickserv:strictpasswords as it is obsolete now nickserv:minpasslen exists.
+Removed nickserv:strictpasswords (obsolete now nickserv:minpasslen exists).
 Removed the inspircd12 and inspircd20 modules (use inspircd instead).
 Removed the ns_getpass module (no supported encryption modules).
 Removed the os_oline module (no supported IRCds).