From f33cbfbebca9389051c020848a2f5538fd25066b Mon Sep 17 00:00:00 2001
From: Alastair Douglas <alastair.douglas@gmail.com>
Date: Thu, 13 Dec 2018 17:55:39 +0000
Subject: [PATCH] Document that new_related cascades to relationships

---
 lib/DBIx/Class/Relationship/Base.pm | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/lib/DBIx/Class/Relationship/Base.pm b/lib/DBIx/Class/Relationship/Base.pm
index b7e74eb58..0ae635b9b 100644
--- a/lib/DBIx/Class/Relationship/Base.pm
+++ b/lib/DBIx/Class/Relationship/Base.pm
@@ -709,6 +709,10 @@ any foreign key columns of the new object to the related primary key columns
 of the source object for you.  The newly created result will not be saved into
 your storage until you call L<DBIx::Class::Row/insert> on it.
 
+If you pass keys that match relationships, the values will be used to create 
+related objects, such that calling C<< ->insert C>> on this new object will
+insert them all.
+
 =cut
 
 sub new_related {