Changes between Version 7 and Version 8 of ExtraPermissionsProvider

Timestamp:

Jan 18, 2017, 2:04:40 AM (7 years ago)

Author:

Ryan J Ollos

Comment:

Copy additional text from comment:4:ticket:11429.

ExtraPermissionsProvider

@@ -3 +3 @@
 Optional component which makes it possible to easily add new permissions to a Trac environment. These can be used for example in configurable [wiki:TracWorkflow]s, when one wants to add a permission specific to a transition, via the `.permissions` key.
 
-To add new permissions, create a new section `[extra-permissions]` in [TracIni#extra-permissions-section trac.ini]. Every entry in that section defines a meta-permission and a comma-separated list of permissions. For example:
+To add new permissions, create a new section `[extra-permissions]` in
+[TracIni#extra-permissions-section trac.ini]. Every entry in that section defines a meta-permission
+and a comma-separated list of permissions. For example:
 {{{#!ini
 [extra-permissions]
 EXTRA_ADMIN = EXTRA_VIEW, EXTRA_MODIFY, EXTRA_DELETE
 }}}
-This entry will define three new permissions `EXTRA_VIEW`, `EXTRA_MODIFY` and `EXTRA_DELETE`, as well as a meta-permission `EXTRA_ADMIN` that grants all three permissions.
+This entry will define three new permissions `EXTRA_VIEW`,
+`EXTRA_MODIFY` and `EXTRA_DELETE`, as well as a meta-permissions
+`EXTRA_ADMIN` that grants all three permissions.
 
-If you don't want a meta-permission, start the meta-name with an underscore (`_`):
+The permissions are created in upper-case characters regardless of
+the casing of the definitions in `trac.ini`. For example, the
+definition `extra_view` would create the permission `EXTRA_VIEW`.
+
+If you don't want a meta-permission, start the meta-name with an
+underscore (`_`):
 {{{#!ini
 [extra-permissions]