From 916f6f7c878bbf093f3d118a212985105597e317 Mon Sep 17 00:00:00 2001
From: Aditya Putta <puttaa@skiff.com>
Date: Wed, 20 Dec 2023 00:50:02 -0600
Subject: [PATCH] using timeout parameter within community.general.mail module
 (#7731)

* using timeout parameter within community.general.mail module

* consolidated time-out example within an existing playbook

* consolidated time-out example within an existing playbook

* Update plugins/modules/mail.py

Co-authored-by: Felix Fontein <felix@fontein.de>

---------

Co-authored-by: Felix Fontein <felix@fontein.de>
---
 plugins/modules/mail.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/plugins/modules/mail.py b/plugins/modules/mail.py
index 825b82c135..13f7c5becd 100644
--- a/plugins/modules/mail.py
+++ b/plugins/modules/mail.py
@@ -205,10 +205,11 @@ EXAMPLES = r'''
     body: System {{ ansible_hostname }} has been successfully provisioned.
     secure: starttls
 
-- name: Sending an e-mail using StartTLS, remote server, custom EHLO
+- name: Sending an e-mail using StartTLS, remote server, custom EHLO, and timeout of 10 seconds
   community.general.mail:
     host: some.smtp.host.tld
     port: 25
+    timeout: 10
     ehlohost: my-resolvable-hostname.tld
     to: John Smith <john.smith@example.com>
     subject: Ansible-report