default_rights directive

[disorder] / README.upgrades

diff --git a/README.upgrades b/README.upgrades
index 915a79416593eb266cc727dadbce86aa7c5db5f5..b47022e5510c040d2f0797e4215a0d61b2d4450d 100644 (file)
--- a/README.upgrades
+++ b/README.upgrades
@@ -14,6 +14,24 @@ upgrading between particular versions.  Minor versions are not
 explicitly mentioned; a version number like 1.1 implicitly includes
 all 1.1.x versions.
 
+* 2.0 -> 2.1
+
+** Authentication
+
+Users are now stored in the database rather than in 'allow' directives in a
+private configuration file.  'allow' is still understood in this version, but
+is only used to populate the database on startup.  After the first (successful)
+run of the server the remaining 'allow' directives should be deleted.
+
+'restrict' and 'trust' are replaced by a system of per-user rights.  The
+default user rights are based on the 'restrict' setting, and the rights of
+users created frow 'allow' directives preserve the meaning of 'trust', but
+after the first run you should remove these directives and (optionally) add a
+'default_rights' directive.
+
+'allow', 'restrict' and 'trust' will stop working entirely in a future version
+but for now they will generate harmless error messages.
+
 * 1.4/1.5 -> 2.0
 
 ** 'transform' and 'namepart' directives