[PATCH] testbot: Document Item::OnDelete().

Francois Gouget fgouget at codeweavers.com
Mon Jan 15 21:02:09 CST 2018

Signed-off-by: Francois Gouget <fgouget at codeweavers.com>
 testbot/lib/ObjectModel/Item.pm | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/testbot/lib/ObjectModel/Item.pm b/testbot/lib/ObjectModel/Item.pm
index 88c9d1ae..62961308 100644
--- a/testbot/lib/ObjectModel/Item.pm
+++ b/testbot/lib/ObjectModel/Item.pm
@@ -433,6 +433,25 @@ sub Validate($)
   return (undef, undef);
+=over 12
+=item C<OnDelete()>
+Prepares the item for deletion.
+The default implementation deletes any related 'Detailref' object as these
+have a foreign key referencing this Item, which would prevent its deletion.
+This allows the deletion of Items even if the database does not support
+'ON DELETE CASCADE'. To preserve this behavior OnDelete() implementations
+should remove any other foreign key that would prevent the deletion of an Item.
+Returns undef if successful, or an error message if the Item should not be
+deleted or something prevents its deletion.
 sub OnDelete($)
   my ($self) = @_;

More information about the wine-devel mailing list