configuration
===============
-.. Copyright (c) 2004-2018 Jeremy Stanley <fungi@yuggoth.org>.
- Permission to use, copy, modify, and distribute this software is
- granted under terms provided in the LICENSE file distributed with
- this software.
+.. Copyright (c) 2004-2020 mudpy authors. Permission to use, copy,
+ modify, and distribute this software is granted under terms
+ provided in the LICENSE file distributed with this software.
.mudpy.filing
-------------
.mudpy.limit.backups: 10
+.mudpy.limit.debug
+~~~~~~~~~~~~~~~~~~
+
+bool, optional
+
+Whether unsafe debugging functionality is enabled. If unspecified or
+set to false, unsafe debugging functions will be disabled. Be very
+careful enabling this feature, as debugging commands may allow service
+administrators to run arbitrary shell commands or modify files
+accessible to the system user under which the service is running.
+
+Example::
+
+ .mudpy.limit.debug: true
+
.mudpy.limit.password_tries
~~~~~~~~~~~~~~~~~~~~~~~~~~~
Example::
.mudpy.timing.status: 6000
+
+.mudpy.user
+-----------
+
+.mudpy.user.pref_admin
+~~~~~~~~~~~~~~~~~~~~~~
+
+list, optional
+
+This can be used to list facets an administrative user is allowed to
+set or override on their own ``account`` element, in addition to any
+in the `.mudpy.user.pref_allow`_ list. Note that this is merely a
+convenience, as an administrator is already able to call the ``set``
+command to set values for facets of any element.
+
+Example::
+
+ .mudpy.user.pref_admin:
+ - loglevel
+
+.mudpy.user.pref_allow
+~~~~~~~~~~~~~~~~~~~~~~
+
+list, optional
+
+This can be used to list facets any user is allowed to set or
+override on their own ``account`` element with the ``preference``
+command.
+
+Example::
+
+ .mudpy.user.pref_allow:
+ - prompt