From aa9ea3d43af43118b9353d6c7bf060acd916122e Mon Sep 17 00:00:00 2001
From: Timo Sand <timo.sand@iki.fi>
Date: Thu, 1 Jun 2017 14:49:35 +0300
Subject: [PATCH] Adds documentation of implicit regex match removal (#24934)

regex_replace has a implicit parameter for `replacement` and thus can remove the matched string
---
 docs/docsite/rst/playbooks_filters.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/docsite/rst/playbooks_filters.rst b/docs/docsite/rst/playbooks_filters.rst
index eb69fbdaed..27e7d8bbf5 100644
--- a/docs/docsite/rst/playbooks_filters.rst
+++ b/docs/docsite/rst/playbooks_filters.rst
@@ -588,6 +588,9 @@ To replace text in a string with regex, use the "regex_replace" filter::
 
     # convert "localhost:80" to "localhost, 80" using named groups
     {{ 'localhost:80' | regex_replace('^(?P<host>.+):(?P<port>\\d+)$', '\\g<host>, \\g<port>') }}
+    
+    # convert "localhost:80" to "localhost"
+    {{ 'localhost:80' | regex_replace(':80') }}
 
 .. note:: Prior to ansible 2.0, if "regex_replace" filter was used with variables inside YAML arguments (as opposed to simpler 'key=value' arguments),
    then you needed to escape backreferences (e.g. ``\\1``) with 4 backslashes (``\\\\``) instead of 2 (``\\``).