Udates by comments

Fixes #5123

Author: AArdeev

doc/reference/reference_lua/box_schema/user_disable.rst

@@ -8,19 +8,20 @@ box.schema.user.disable()
 
 .. function:: box.schema.user.disable(username)
 
-    Initiates the :samp:`box.schema.user.revoke('{username}','usage,session','universe',nil,` :code:`{if_exists=true})`
-    (see section :ref:`box.schema.user.revoke <box_schema-user_revoke>`).
-
-    :param string username: the name of a user to be deactivated
- 
-    :return: (if success) ``---``
-
-             (if failure) ``error: User 'username' is not found``
+    Revokes ``usage`` and ``session`` permissions from the subject user. Equivalent to the following call:
 
+        ..  code-block:: lua
+            box.schema.user.revoke('{username}','usage,session','universe',nil,{if_not_exists=true})            
+    
+    .. NOTE::
 
-    **Example:**
+    ``session`` - (cannot be granted to a role) if is not granted, ``IPROTO_AUTH`` always fails connection to the user, so does ``box.session.su()``
+    ``usage`` - (cannot be granted to a role) lets user use their privileges on database objects (e.g. read, write and alter space)
+    
+    For more information about revoking permissions see section :ref:`box.schema.user.revoke <box_schema-user_revoke>`.
 
-        ..  code-block:: lua
+    :param string username: the name of the subject user
+ 
+    :return: (if success) nothing
 
-            box.schema.user.disable (username)       
-            ---
+             (if failure) The error is raised ``- error: User 'username' is not found``

doc/reference/reference_lua/box_schema/user_enable.rst

@@ -8,18 +8,20 @@ box.schema.user.enable()
 
 .. function:: box.schema.user.enable(username)
 
-    Initiates the :samp:`box.schema.user.grant('{username}','usage,session','universe',nil,` :code:`{if_not_exists=true})` method
-    (see section :ref:`box.schema.user.grant <box_schema-user_grant>`).
+    Grants ``usage`` and ``session`` permissions to the subject user. Equivalent to the following call:
 
-    :param string username: the name of the subject user
- 
-    :return: (if success) ``---``
-
-             (if failure) ``error: User 'username' is not found``
+        ..  code-block:: lua
+            box.schema.user.grant('{username}','usage,session','universe',nil,{if_not_exists=true})            
+    
+    .. NOTE::
 
-    **Example:**
+    ``session`` - (cannot be granted to a role) if is not granted, ``IPROTO_AUTH`` always fails connection to the user, so does ``box.session.su()``
+    ``usage`` - (cannot be granted to a role) lets user use their privileges on database objects (e.g. read, write and alter space)
+    
+    For more information about granting permissions see section :ref:`box.schema.user.grant <box_schema-user_grant>`.
 
-        ..  code-block:: lua
+    :param string username: the name of the subject user
+ 
+    :return: (if success) nothing
 
-            box.schema.user.enable (username)            
-            ---
+             (if failure) The error is raised ``- error: User 'username' is not found``