From bc5af5a775bfec207104cb418243ad3dbb5ef780 Mon Sep 17 00:00:00 2001
From: Eric Coulter <jecoulte@iu.edu>
Date: Fri, 19 Oct 2018 14:31:03 -0400
Subject: [PATCH] Update documentation for marker (#47292)

Using blockinfile with a custom marker lacking {mark} results in non-idempotency - block is repeatedly inserted on subsequent playbook runs.

+label: docsite_pr
---
 lib/ansible/modules/files/blockinfile.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/lib/ansible/modules/files/blockinfile.py b/lib/ansible/modules/files/blockinfile.py
index 75f3c164d3e..dc6a9e76e83 100644
--- a/lib/ansible/modules/files/blockinfile.py
+++ b/lib/ansible/modules/files/blockinfile.py
@@ -40,6 +40,7 @@ options:
     description:
     - The marker line template.
     - C({mark}) will be replaced with the values C(in marker_begin) (default="BEGIN") and C(marker_end) (default="END").
+    - Using a custom marker without the C({mark}) variable may result in the block being repeatedly inserted on subsequent playbook runs.
     type: str
     default: '# {mark} ANSIBLE MANAGED BLOCK'
   block: