Fix typos in docs

[src/app-framework-main.git] / docs / permissions.md

diff --git a/docs/permissions.md b/docs/permissions.md
index 300a719..407fdc2 100644 (file)
--- a/docs/permissions.md
+++ b/docs/permissions.md
@@ -7,38 +7,38 @@ Permission's names
 
 The proposal here is to specify a naming scheme for permissions
 that allows the system to be as stateless as possible. The current
-current specification includes in the naming of permissions either
+specification includes in the naming of permissions either
 the name of the bound binding when existing and the level of the
 permission itself. Doing this, there is no real need for the
-framework to keep updated a database of installed permissions.
+framework to keep installed permissions in a database.
 
 The permission names are [URN][URN] of the form:
 
-  urn:AGL:permission:<binding>:<level>:<hierarchical-name>
+  urn:AGL:permission:<api>:<level>:<hierarchical-name>
 
 where "AGL" is the NID (the namespace identifier) dedicated to
 AGL (note: a RFC should be produced to standardize this name space).
 
 The permission names are made of NSS (the namespace specific string)
 starting with "permission:" and followed by colon separated
-fields. The 2 first fields are <binding> and <level> and the remaining
-fields are gouped to form the <hierarchical-name>.
+fields. The 2 first fields are <api> and <level> and the remaining
+fields are grouped to form the <hierarchical-name>.
+
+       <api> ::= [ <pname> ]
 
-       <binding> ::= [ <pname> ]
-       
        <pname> ::= 1*<pchars>
-       
+
        <pchars> ::= <upper> | <lower> | <number> | <extra>
-       
+
        <extra> ::= "-" | "." | "_" | "@"
 
-The field <binding> can be made of any valid character for NSS except
-the characters colon and star (:*). This field designate the binding
-providing the permission. It is use to deduce binding requirements
-from permission requirements. The field <binding> can be the empty
+The field <api> can be made of any valid character for NSS except
+the characters colon and star (:*). This field designates the api
+providing the permission. This scheme is used to deduce binding requirements
+from permission requirements. The field <api> can be the empty
 string when the permission is defined by the AGL system itself.
-The field <binding> if starting with the character "@" represents
-a transversal permission not bound to any binding.
+The field <api> if starting with the character "@" represents
+a transversal/cross permission not bound to any binding.
 
        <level> ::= 1*<lower>