docs for if_not_submitted parameter
authorAlexander Hartmaier <alexander.hartmaier@t-systems.at>
Mon, 4 Oct 2010 10:39:24 +0000 (12:39 +0200)
committerAlexander Hartmaier <alexander.hartmaier@t-systems.at>
Mon, 4 Oct 2010 10:39:24 +0000 (12:39 +0200)
lib/DBIx/Class/ResultSet/RecursiveUpdate.pm

index 024511a71b90df00a75474cf39adc4f37379e110..a8db9d257ca21958cb9de486eceb649bd844fe6c 100644 (file)
@@ -456,10 +456,24 @@ Clearing the relationship:
 
 =head2 Treatment of has_many relations
 
-In case the relationship is included but undefined or an empty array, the
-related rows will be deleted or their foreign key column set to null depending
-on if_not_submitted parameter (set_to_null or delete).
-It defaults to undefined which skips both.
+If a relationship key is included in the data structure with a value of undef
+or an empty array, all existing related rows will be deleted, or their foreign
+key columns will be set to null.
+
+The exact behaviour depends on the nullability of the foreign key columns and
+the value of the "if_not_submitted" parameter. The parameter defaults to
+undefined which neither nullifies nor deletes.
+
+When the array contains elements they are updated if they exist, created when
+not and deleted if not included.
+
+=head3 All foreign table columns are nullable
+
+In this case recursive_update defaults to nullifying the foreign columns.
+
+=head3 Not all foreign table columns are nullable
+
+In this case recursive_update deletes the foreign rows.
 
 Updating the relationship:
 
This page took 0.021579 seconds and 4 git commands to generate.