X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=catagits%2FCatalyst-Runtime.git;a=blobdiff_plain;f=lib%2FCatalyst%2FUpgrading.pod;h=bce2a1418f981e285068564ed2f2581807a3138e;hp=7d45923d8de1a8318890284b6d06d863ca1e90cd;hb=ade3da0a3602627512932eef9af511247f11634f;hpb=409d48fb495802db8eb6e02a927dd2915d8643b4

diff --git a/lib/Catalyst/Upgrading.pod b/lib/Catalyst/Upgrading.pod
index 7d45923..bce2a14 100644
--- a/lib/Catalyst/Upgrading.pod
+++ b/lib/Catalyst/Upgrading.pod
@@ -32,6 +32,12 @@ UTF-8.  We'll add it for you if you continue to use the stand alone plugin and
 we detect this, but this backwards compatibility shim will likely be removed in
 a few releases (trying to clean up the codebase after all).
 
+B<NOTE>: One other difference between the cored plugin and the stand alone one
+is that in core we no longer throw an exception when there's a decode failure
+but instead log a warning.  If you rely on exceptions for control flow, you 
+will need to override method C<handle_unicode_encoding_exception> to die instead
+of warning.  Please let the dev team know if this is a problem for you.
+
 If you have trouble with any of this, please bring it to the attention of the
 Catalyst maintainer group.