Merge branch 'master' into australorp

[catagits/Catalyst-Runtime.git] / lib / Catalyst / Upgrading.pod

diff --git a/lib/Catalyst/Upgrading.pod b/lib/Catalyst/Upgrading.pod
index fe9da9c..ebfa2a3 100644 (file)
--- a/lib/Catalyst/Upgrading.pod
+++ b/lib/Catalyst/Upgrading.pod
@@ -15,6 +15,14 @@ UTF8 is enabled going forwards and the expectation is that other ecosystem
 projects will assume this as well.  At some point you application will not
 correctly function without this setting.
 
+As of 5.90084 we've added two additional configuration flags for more selective
+control over some encoding changes: 'skip_body_param_unicode_decoding' and
+'skip_complex_post_part_handling'.  You may use these to more selectively
+disable new features while you are seeking a long term fix.  Please review
+CONFIGURATION in L<Catalyst>.
+
+For further information, please see L<Catalyst::UTF8>
+
 A number of projects in the wider ecosystem required minor updates to be able
 to work correctly.  Here's the known list:
 
@@ -54,7 +62,7 @@ to add a configuration setting for the encoding type.  For example:
 
 Please note that this is different from the old stand alone plugin which applied
 C<UTF-8> encoding by default (that is, if you did not set an explicit
-C<encoding> configuration value, it assumed you wanted UTF-8).  In order to 
+C<encoding> configuration value, it assumed you wanted UTF-8).  In order to
 preserve backwards compatibility you will need to explicitly turn it on via the
 configuration setting.  THIS MIGHT CHANGE IN THE FUTURE, so please consider
 starting to test your application with proper UTF-8 support and remove all those
@@ -622,7 +630,7 @@ same effect.
 Having actions in your application class will now emit a warning at application
 startup as this is deprecated. It is highly recommended that these actions are moved
 into a MyApp::Controller::Root (as demonstrated by the scaffold application
-generated by catalyst.pl). 
+generated by catalyst.pl).
 
 This warning, also affects tests. You should move actions in your test,
 creating a myTest::Controller::Root, like the following example:
@@ -638,7 +646,7 @@ creating a myTest::Controller::Root, like the following example:
 
     sub action : Local {
         my ( $self, $c ) = @_;
-        $c->do_something; 
+        $c->do_something;
     }
 
     1;