Credentials: update per TW review - update reference

Author: andreyaksenov

doc/reference/reference_lua/box_schema/role_create.rst

@@ -22,7 +22,10 @@ box.schema.role.create()
 
     **Example:**
 
-    .. code-block:: lua
+    ..  literalinclude:: /code_snippets/test/access_control/grant_roles_test.lua
+        :language: lua
+        :start-after: Create roles
+        :end-before: End: Create roles
+        :dedent:
 
-        box.schema.role.create('Accountant')
-        box.schema.role.create('Accountant', {if_not_exists = false})
+    See also: :ref:`access_control_roles`.

doc/reference/reference_lua/box_schema/role_drop.rst

@@ -18,6 +18,10 @@ box.schema.role.drop()
 
     **Example:**
 
-    .. code-block:: lua
+    ..  literalinclude:: /code_snippets/test/access_control/grant_roles_test.lua
+        :language: lua
+        :start-after: Dropping a role
+        :end-before: End: Dropping a role
+        :dedent:
 
-        box.schema.role.drop('Accountant')
+    See also: :ref:`access_control_roles`.

doc/reference/reference_lua/box_schema/role_exists.rst

@@ -13,8 +13,4 @@ box.schema.role.exists()
     :param string role-name: the name of the role
     :rtype: bool
 
-    **Example:**
-
-    .. code-block:: lua
-
-        box.schema.role.exists('Accountant')
+    See also: :ref:`access_control_roles_info`.

doc/reference/reference_lua/box_schema/role_grant.rst

@@ -31,10 +31,10 @@ box.schema.role.grant()
 
     **Example:**
 
-    .. code-block:: lua
+    ..  literalinclude:: /code_snippets/test/access_control/grant_roles_test.lua
+        :language: lua
+        :start-after: Grant read/write privileges to a role
+        :end-before: Grant write privileges to a role
+        :dedent:
 
-        box.schema.role.grant('Accountant', 'read', 'space', 'tester')
-        box.schema.role.grant('Accountant', 'execute', 'function', 'f')
-        box.schema.role.grant('Accountant', 'read,write', 'universe')
-        box.schema.role.grant('public', 'Accountant')
-        box.schema.role.grant('role1', 'role2', nil, nil, {if_not_exists=false})
+    See also: :ref:`access_control_roles`.

doc/reference/reference_lua/box_schema/role_info.rst

@@ -12,8 +12,4 @@ box.schema.role.info()
 
     :param string role-name: the name of the role.
 
-    **Example:**
-
-    .. code-block:: lua
-
-        box.schema.role.info('Accountant')
+    See also: :ref:`access_control_roles_info`.

doc/reference/reference_lua/box_schema/role_revoke.rst

@@ -25,11 +25,4 @@ box.schema.role.revoke()
     **Variation:** instead of ``privilege, object-type, object-name`` say
     ``role-name``.
 
-    **Example:**
-
-    .. code-block:: lua
-
-        box.schema.role.revoke('Accountant', 'read', 'space', 'tester')
-        box.schema.role.revoke('Accountant', 'execute', 'function', 'f')
-        box.schema.role.revoke('Accountant', 'read,write', 'universe')
-        box.schema.role.revoke('public', 'Accountant')
+    See also: :ref:`access_control_roles`.

doc/reference/reference_lua/box_schema/user_create.rst

@@ -21,7 +21,7 @@ box.schema.user.create()
     * ``password`` (default = '') - string; the ``password`` = *password*
       specification is good because in a :ref:`URI <index-uri>`
       (Uniform Resource Identifier) it is usually illegal to include a
-      user-name without a password.
+      username without a password.
 
     .. NOTE::
 
@@ -34,8 +34,10 @@ box.schema.user.create()
 
     **Examples:**
 
-    .. code-block:: lua
+    ..  literalinclude:: /code_snippets/test/access_control/grant_user_privileges_test.lua
+        :language: lua
+        :start-after: Create a user with a password
+        :end-before: End: Create a user with a password
+        :dedent:
 
-        box.schema.user.create('testuser')
-        box.schema.user.create('testuser', {password = 'foobar'})
-        box.schema.user.create('testuser', {if_not_exists = false})
+    See also: :ref:`access_control_users`.

doc/reference/reference_lua/box_schema/user_drop.rst

@@ -6,20 +6,23 @@ box.schema.user.drop()
 
 .. module:: box.schema
 
-.. function:: box.schema.user.drop(user-name [, {options}])
+.. function:: box.schema.user.drop(username [, {options}])
 
     Drop a user.
     For explanation of how Tarantool maintains user data, see
     section :ref:`Users <authentication-users>` and reference on
     :ref:`_user <box_space-user>` space.
 
-    :param string user-name: the name of the user
+    :param string username: the name of the user
     :param table options: ``if_exists`` = ``true|false`` (default = ``false``) - boolean;
                           ``true`` means there should be no error if the user does not exist.
 
     **Examples:**
 
-    .. code-block:: lua
+    ..  literalinclude:: /code_snippets/test/access_control/grant_user_privileges_test.lua
+        :language: lua
+        :start-after: Drop a user
+        :end-before: End: Drop a user
+        :dedent:
 
-        box.schema.user.drop('Lena')
-        box.schema.user.drop('Lena',{if_exists=false})
+    See also: :ref:`access_control_users`.

doc/reference/reference_lua/box_schema/user_exists.rst

@@ -6,18 +6,14 @@ box.schema.user.exists()
 
 .. module:: box.schema
 
-.. function:: box.schema.user.exists(user-name)
+.. function:: box.schema.user.exists(username)
 
     Return ``true`` if a user exists; return ``false`` if a user does not exist.
     For explanation of how Tarantool maintains user data, see
     section :ref:`Users <authentication-users>` and reference on
     :ref:`_user <box_space-user>` space.
 
-    :param string user-name: the name of the user
+    :param string username: the name of the user
     :rtype: bool
 
-    **Example:**
-
-    .. code-block:: lua
-
-        box.schema.user.exists('Lena')
+    See also: :ref:`access_control_user_info`.

doc/reference/reference_lua/box_schema/user_grant.rst

@@ -6,14 +6,14 @@ box.schema.user.grant()
 
 .. module:: box.schema
 
-.. function:: box.schema.user.grant(user-name, privileges, object-type, object-name[, {options} ])
-              box.schema.user.grant(user-name, privileges, 'universe'[, nil, {options} ])
-              box.schema.user.grant(user-name, role-name[, nil, nil, {options} ])
+.. function:: box.schema.user.grant(username, privileges, object-type, object-name[, {options} ])
+              box.schema.user.grant(username, privileges, 'universe'[, nil, {options} ])
+              box.schema.user.grant(username, role-name[, nil, nil, {options} ])
 
     Grant :ref:`privileges <authentication-owners_privileges>` to a user or
     to another role.
 
-    :param string   user-name: the name of a user to grant privileges to
+    :param string   username: the name of a user to grant privileges to
     :param string  privileges: one or more privileges to grant to the user (for example, `read` or `read,write`)
     :param string object-type: a database object type to grant privileges to (for example, `space`, `role`, or `function`)
     :param string object-name: the name of a database object to grant privileges to
@@ -30,8 +30,8 @@ box.schema.user.grant()
     ``role-name`` (see section :ref:`Roles <authentication-roles>`).
 
     **Variation:** instead of
-    :samp:`box.schema.user.grant('{user-name}','usage,session','universe',nil,` :code:`{if_not_exists=true})`
-    say :samp:`box.schema.user.enable('{user-name}')`.
+    :samp:`box.schema.user.grant('{username}','usage,session','universe',nil,` :code:`{if_not_exists=true})`
+    say :samp:`box.schema.user.enable('{username}')`.
 
     The possible options are:
 
@@ -41,11 +41,10 @@ box.schema.user.grant()
 
     **Example:**
 
-    .. code-block:: lua
+    ..  literalinclude:: /code_snippets/test/access_control/grant_user_privileges_test.lua
+        :language: lua
+        :start-after: Grant privileges to the specified user
+        :end-before: End: Grant privileges to the specified user
+        :dedent:
 
-        box.schema.user.grant('Lena', 'read', 'space', 'tester')
-        box.schema.user.grant('Lena', 'execute', 'function', 'f')
-        box.schema.user.grant('Lena', 'read,write', 'universe')
-        box.schema.user.grant('Lena', 'Accountant')
-        box.schema.user.grant('Lena', 'read,write,execute', 'universe')
-        box.schema.user.grant('X', 'read', 'universe', nil, {if_not_exists=true})
+    See also: :ref:`access_control_users`.