From 39fd899d83cfcbc6aa313512d2a7f61ac97cfa8a Mon Sep 17 00:00:00 2001
From: Klaus Frank <agowa338@users.noreply.github.com>
Date: Mon, 27 Feb 2023 18:15:18 +0100
Subject: [PATCH] Clarify combine filter examples (#80078)

---
 lib/ansible/plugins/filter/combine.yml | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/lib/ansible/plugins/filter/combine.yml b/lib/ansible/plugins/filter/combine.yml
index 86788f31079..4787b447c5e 100644
--- a/lib/ansible/plugins/filter/combine.yml
+++ b/lib/ansible/plugins/filter/combine.yml
@@ -34,9 +34,14 @@ DOCUMENTATION:
 EXAMPLES: |
 
     # ab => {'a':1, 'b':3, 'c': 4}
-    ab: {{ {'a':1, 'b':2} | combine({'b':3, 'c':4}) }}
+    ab: {{ {'a':1, 'b':2} | ansible.builtin.combine({'b':3, 'c':4}) }}
 
-    many: "{{ dict1 | combine(dict2, dict3, dict4) }}"
+    many: "{{ dict1 | ansible.builtin.combine(dict2, dict3, dict4) }}"
+    
+    # defaults => {'a':{'b':3, 'c':4}, 'd': 5}
+    # customization => {'a':{'c':20}}
+    # final => {'a':{'b':3, 'c':20}, 'd': 5}
+    final: "{{ defaults | ansible.builtin.combine(customization, recursive=true) }}"
 
 RETURN:
   _value: