X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FCatalyst%2FUpgrading.pod;h=5cc702d53540fb996a31596ade5744f06be2a30f;hb=ca5d34dfc295012a749a8454d2b213580e03d55c;hp=db8153a0ce7c6086d9d45ff095514a421dd296b6;hpb=862a7989fa3f15fe333c9fe46197e9840fc62808;p=catagits%2FCatalyst-Runtime.git diff --git a/lib/Catalyst/Upgrading.pod b/lib/Catalyst/Upgrading.pod index db8153a..5cc702d 100644 --- a/lib/Catalyst/Upgrading.pod +++ b/lib/Catalyst/Upgrading.pod @@ -65,7 +65,7 @@ script is upgraded to use L. If you were using L there is no upgrade needed if your myapp_cgi.pl script is already upgraded to use L. -=head2 Upgrading the Preforking Engine +=head2 Upgrading Catalyst::Engine::HTTP::Prefork If you were using L then L is automatically loaded. You should (at least) change your C @@ -141,7 +141,6 @@ In the simplest case: becomes - MyCatalystApp->setup_engine('PSGI'); my $app = MyCatalystApp->psgi_app(@_); B: @@ -157,6 +156,10 @@ any tests run via L will not be compatible with the new release, and will result in the development server starting, rather than the expected test running. +B If you are directly accessing C<< $c->req->env >> to get the PSGI +environment then this accessor is moved to C<< $c->engine->env >>, +you will need to update your code. + =head2 Engines which are known to be broken The following engines B work as of Catalyst version 5.9. The @@ -194,10 +197,6 @@ Reports are highly encouraged: =back -=head2 Specifying the engine in the call to ->setup - -XXX FIXME - =head2 Plack functionality See L. @@ -224,7 +223,7 @@ been made which could cause incompatibilities. If your application or plugin is using deprecated code, or relying on side effects, then you could have issues upgrading to this release. -Most issues found with pre-existing components have been easy to +Most issues found with existing components have been easy to solve. This document provides a complete description of behavior changes which may cause compatibility issues, and of new Catalyst warnings which might be unclear. @@ -282,7 +281,7 @@ replaces L with L, forcing all components to resolve methods using C3, rather than the unpredictable dispatch order of L. -This issue is characterised by your application failing to start due to an +This issue manifests itself by your application failing to start due to an error message about having a non-linear @ISA. The Catalyst plugin most often causing this is @@ -489,7 +488,7 @@ The following test demonstrates the problem: use Test::More; isnt(BaseClass->can('foo'), Child->can('foo')); -=head2 Extending Catalyst::Request or other classes in an ad-hoc manner using mk_accessors +=head2 Extending Catalyst::Request or other classes in an ad hoc manner using mk_accessors Previously, it was possible to add additional accessors to Catalyst::Request (or other classes) by calling the mk_accessors class method.