diff --git a/ChangeLog b/ChangeLog
index eb558ce3d..08d973e8e 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2015-08-21 Peter Stephenson
+
+ * 36250, tweaked: README: highlight bracketed paste mode.
+
2015-08-20 Jun-ichi Takimoto
* 36243: Completion/Unix/Type/_pids: fix a few problems of
diff --git a/NEWS b/NEWS
index e6bd73245..7c7466c5d 100644
--- a/NEWS
+++ b/NEWS
@@ -4,8 +4,8 @@ CHANGES FROM PREVIOUS VERSIONS OF ZSH
Note also the list of incompatibilities in the README file.
-Changes from 5.0.8 to 5.0.9
----------------------------
+Changes from 5.0.8 to 5.1
+-------------------------
The builtins declare, export, local, readonly and typeset
now have corresponding reserved words. When used in
diff --git a/README b/README
index 745ee6fce..552f4731f 100644
--- a/README
+++ b/README
@@ -30,8 +30,17 @@ Zsh is a shell with lots of features. For a list of some of these, see the
file FEATURES, and for the latest changes see NEWS. For more
details, see the documentation.
-Incompatibilites between 5.0.8 and 5.0.9
-----------------------------------------
+Incompatibilites between 5.0.8 and 5.1
+--------------------------------------
+
+The default behaviour when text is pasted into an X Windows terminal has
+changed significantly (unless you are using a very old terminal emulator
+that doesn't support this mode). Now, the new "bracketed paste mode"
+treats all the pasted text as literal characters. This means, in
+particular, that a newline is simply inserted as a visible newline; you
+need to hit Return on the keyboard to execute the pasted text in one go.
+See the description of zle_bracketed_paste in the zshparams manual for
+more. "unset zle_bracketed_paste" restores the previous behaviour.
As noted in NEWS, the builtins declare, export, float, integer, local,
readonly and typeset now have corresponding reserved words that provide