Document "m" For Deleting Groups (#1828)

* Document That `Group.delete()` Should Be Opened in 'm' Mode

Author: nguyenv

tiledb/group.py

@@ -22,7 +22,7 @@ class Group(CtxMixin, lt.Group):
 
     :param uri: The URI to the Group
     :type uri: str
-    :param mode: Read mode ('r') or write mode ('w')
+    :param mode: Read mode ('r'), write mode ('w'), or modify exclusive ('m')
     :type mode: str
     :param config: A TileDB config
     :type config: Config or dict
@@ -67,6 +67,11 @@ class Group(CtxMixin, lt.Group):
     >>> grp.open("w")
     >>> grp.remove(subgrp_path)
     >>> grp.close()
+    >>>
+    >>> # Delete the subgroup
+    >>> grp.open("m")
+    >>> grp.delete(subgrp_path)
+    >>> grp.close()
     """
 
     _NP_DATA_PREFIX = "__np_flat_"
@@ -320,7 +325,7 @@ def add(self, uri: str, name: str = None, relative: bool = False):
 
     def delete(self, recursive: bool = False):
         """
-        Delete a Group.
+        Delete a Group. The group needs to be opened in 'm' mode.
 
         :param uri: The URI of the group to delete
         """
@@ -431,7 +436,7 @@ def uri(self) -> str:
     @property
     def mode(self) -> str:
         """
-        :return: Read mode ('r') or write mode ('w')
+        :return: Read mode ('r'), write mode ('w'), or modify exclusive ('m')
         :rtype: str
         """
         return self._query_type_to_mode[self._query_type]