From fade5b7936342bd289e20da7413617780bb330b6 Mon Sep 17 00:00:00 2001
From: Brian Coca <brian.coca+git@gmail.com>
Date: Wed, 24 Feb 2016 08:39:53 -0500
Subject: [PATCH] added docs to blockinfile with_ interactions

fixes #1592
---
 files/blockinfile.py | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/files/blockinfile.py b/files/blockinfile.py
index a40f57a863c..c2e449b2edc 100644
--- a/files/blockinfile.py
+++ b/files/blockinfile.py
@@ -38,6 +38,7 @@ description:
     surrounded by customizable marker lines.
 notes:
   - This module supports check mode.
+  - When using 'with_' loops be aware that if you do not set a unique mark the block will be overwritten on each iteration.
 options:
   dest:
     aliases: [ name, destfile ]
@@ -136,6 +137,17 @@ EXAMPLES = r"""
     dest: /var/www/html/index.html
     marker: "<!-- {mark} ANSIBLE MANAGED BLOCK -->"
     content: ""
+
+- name: insert/update "Match User" configuation block in /etc/ssh/sshd_config
+  blockinfile:
+    dest: /etc/hosts
+    block: |
+      {{item.name}} {{item.ip}}
+    marker: "# {mark} ANSIBLE MANAGED BLOCK {{item.name}}"
+    with_items:
+        - { name: host1, ip: 10.10.1.10 }
+        - { name: host2, ip: 10.10.1.11 }
+        - { name: host3, ip: 10.10.1.12 }
 """