From e4a05feef3840d8b1a45d7010eafbe5208c96126 Mon Sep 17 00:00:00 2001
From: Martin Renvoize <martin.renvoize@ptfs-europe.com>
Date: Fri, 29 Oct 2021 13:22:59 +0100
Subject: [PATCH] Bug 28729: Additions to POD

Signed-off-by: Jonathan Druart <jonathan.druart@bugs.koha-community.org>
---
 Koha/Email.pm | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/Koha/Email.pm b/Koha/Email.pm
index f3f0eee7e1..a5303c3c0b 100644
--- a/Koha/Email.pm
+++ b/Koha/Email.pm
@@ -150,10 +150,16 @@ sub create {
 
     $email->send_or_die({ transport => $transport [, $args] });
 
-Overloaded Email::Stuffer I<send_or_die> method, that takes care of Bcc handling.
+Overloaded Email::Stuffer I<send_or_die> method, that takes care of Bcc and Return-path
+handling.
+
 Bcc is removed from the message headers, and included in the recipients list to be
 passed to I<send_or_die>.
 
+Return-path, 'MAIL FROM', is set to the 'Sender' email header unless an explicit 'from'
+parameter is passed to send_or_die.  'Return-path' headers are actually set by the MTA,
+usually using the 'MAIL FROM' information set at mail server connection time.
+
 =cut
 
 sub send_or_die {
-- 
2.39.5