From 21ee4b02da89db6de7008de6e4a829d6cdc66fd2 Mon Sep 17 00:00:00 2001
From: Toshio Kuratomi <toshio@fedoraproject.org>
Date: Thu, 3 Sep 2015 15:23:33 -0700
Subject: Add more details to the changelog -- may move this to a porting guide
 later

---
 CHANGELOG.md | 22 +++++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index b19ece3baf..40f50fdc81 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -42,7 +42,27 @@ Major Changes:
  * When a string with a trailing newline was specified in the playbook via yaml
    dict format, the trailing newline was stripped.  When specified in key=value
    format the trailing newlines were kept.  In v2, both methods of specifying the
-   string will keep the trailing newlines.
+   string will keep the trailing newlines.  If you relied on the trailing
+   newline being stripped you can change your playbook like this::
+
+     # Syntax in 1.9.2
+     vars:
+       message: >
+         Testing
+         some things
+     tasks:
+     - debug:
+         msg: "{{ message }}"
+     # Syntax in 2.0.x
+     vars:
+       old_message: >
+         Testing
+         some things
+       message: "{{ old_messsage[:-1] }}"
+     - debug:
+         msg: "{{ message }}"
+     # Output
+     "msg": "Testing some things"
 
 Deprecated Modules (new ones in parens):
   * ec2_ami_search (ec2_ami_find)
-- 
cgit v1.2.1