From fe2ac51b2732befe9e4f9b8d2c85d6d94de525a3 Mon Sep 17 00:00:00 2001
From: Tomas Cohen Arazi <tomascohen@theke.io>
Date: Mon, 4 May 2020 09:54:30 -0300
Subject: [PATCH] Bug 23185: (QA follow-up) Add POD for Koha::Objects->update

Signed-off-by: Tomas Cohen Arazi <tomascohen@theke.io>
Signed-off-by: Martin Renvoize <martin.renvoize@ptfs-europe.com>
---
 Koha/Objects.pm | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/Koha/Objects.pm b/Koha/Objects.pm
index 94271928b1..f39061aee9 100644
--- a/Koha/Objects.pm
+++ b/Koha/Objects.pm
@@ -196,6 +196,17 @@ sub delete {
 
 =head3 update
 
+    $object->update( $fields, [ { no_triggers => 0/1 } ] );
+
+This method overloads the DBIC inherited one so if code-level triggers exist
+(through the use of an overloaded I<update> or I<store> method in the Koha::Object
+based class) those are called in a loop on the resultset.
+
+If B<no_triggers> is passed and I<true>, then the DBIC update method is called
+directly. This feature is important for performance, in cases no code-level
+triggers are defined. The developer will explicitly ask for this and QA should
+catch wrong uses as well.
+
 =cut
 
 sub update {
-- 
2.39.5