Add documentation for squash_actions configuration setting

1 files changed, 6 insertions, 0 deletions

diff --git a/examples/ansible.cfg b/examples/ansible.cfg
index fe60bc71aa..98657cc062 100644
--- a/examples/ansible.cfg
+++ b/examples/ansible.cfg
@@ -199,6 +199,12 @@
 #retry_files_enabled = False
 #retry_files_save_path = ~/.ansible-retry
 
+# squash actions
+# Ansible can optimise actions that call modules with list parameters
+# when looping. Instead of calling the module once per with_ item, the
+# module is called once with all items at once. Currently this only works
+# under limited circumstances, and only with parameters named 'name'.
+#squash_actions = apk,apt,dnf,package,pacman,pkgng,yum,zypper
 
 # prevents logging of task data, off by default
 #no_log = False