From 06920b2e47668898f7b4ec13a2f012afa7fece94 Mon Sep 17 00:00:00 2001
From: James Tanner <tanner.jc@gmail.com>
Date: Mon, 31 Mar 2014 14:12:16 -0400
Subject: [PATCH] Add docs examples for regex_replace

---
 docsite/rst/playbooks_variables.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docsite/rst/playbooks_variables.rst b/docsite/rst/playbooks_variables.rst
index 3b5907e3301..44e9f1edca8 100644
--- a/docsite/rst/playbooks_variables.rst
+++ b/docsite/rst/playbooks_variables.rst
@@ -240,6 +240,14 @@ doesn't know it is a boolean value::
    - debug: msg=test
      when: some_string_value | bool
 
+To replace text in a string with regex, use the "regex_replace" filter::
+
+    # convert "ansible" to "able"    
+    {{ 'ansible' | regex_replace('^a.*i(.*)$', 'a\\1') }}         
+
+    # convert "foobar" to "bar"
+    {{ 'foobar' | regex_replace('^f.*o(.*)$', '\\1') }}
+
 A few useful filters are typically added with each new Ansible release.  The development documentation shows
 how to extend Ansible filters by writing your own as plugins, though in general, we encourage new ones
 to be added to core so everyone can make use of them.