WIP: Add doc, add revisit part in tests

Author: CBroz1

datajoint/table.py

@@ -486,7 +486,7 @@ def delete(
         transaction: bool = True,
         safemode: Union[bool, None] = None,
         force_parts: bool = False,
-        include_parts: bool = True,
+        force_masters: bool = True,
     ) -> int:
         """
         Deletes the contents of the table and its dependent tables, recursively.

docs/src/manipulation/delete.md

@@ -27,4 +27,5 @@ consequence of deleting the master table.
 
 To enforce this workflow, calling `delete` directly on a part table produces an error.
 In some cases, it may be necessary to override this behavior.
-To remove entities from a part table without calling `delete` master, use the argument `force=True`.
+To remove entities from a part table without calling `delete` master, use the argument `force_parts=True`.
+To include the correponding entries in the master table, use the argument `force_masters=True`.

tests/schema_simple.py

@@ -125,10 +125,18 @@ class H(dj.Part):
         id_h :int
         """
 
+    class I(dj.Part): 
+        definition = """ # test force_masters revisit part
+        -> E
+        id_i :int
+        ---
+        -> H
+        """
+
     def make(self, key):
         random.seed(str(key))
         l_contents = list(L().fetch("KEY"))
-        part_f, part_g, part_h = E.F(), E.G(), E.H()
+        part_f, part_g, part_h, part_i = E.F(), E.G(), E.H(), E.I()
         bc_references = list((B.C() & key).fetch("KEY"))
         random.shuffle(bc_references)
 
@@ -141,6 +149,7 @@ def make(self, key):
         g_inserts = [dict(key, id_g=i, **ref) for i, ref in enumerate(l_contents)]
         part_g.insert(g_inserts)
         part_h.insert(dict(key, id_h=i) for i in range(4))
+        part_i.insert(dict(key, id_i=i, **random.choice(g_inserts)) for i in range(4))
 
 
 class F(dj.Manual):