From: Jesse Sheidlower <jester@panix.com>
Date: Sun, 14 Aug 2011 20:12:59 +0000 (-0400)
Subject: Merge branch 'master' of ssh://git.shadowcat.co.uk/Catalyst-Runtime
X-Git-Tag: 5.9000~6
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=catagits%2FCatalyst-Runtime.git;a=commitdiff_plain;h=862a7989fa3f15fe333c9fe46197e9840fc62808

Merge branch 'master' of ssh://git.shadowcat.co.uk/Catalyst-Runtime

Conflicts:
	lib/Catalyst/Upgrading.pod
---

862a7989fa3f15fe333c9fe46197e9840fc62808
diff --cc lib/Catalyst/Upgrading.pod
index 1955bfb,4fec7d3..db8153a
--- a/lib/Catalyst/Upgrading.pod
+++ b/lib/Catalyst/Upgrading.pod
@@@ -4,17 -4,14 +4,17 @@@ Catalyst::Upgrading - Instructions for 
  
  =head1 Upgrading to Catalyst 5.9
  
 -The major change is that L<Plack> now replaces most of the subclasses of
 -L<Catalyst::Engine>.  If you are using one of the standard subclasses of
 -L<Catalyst::Engine> this should be a straightforward upgrade for you. It was
 -a design goal for this release to be as backwardly compatible as possible.
 -However since L<Plack> is different from L<Catalyst::Engine> it is possible
 -that edge case differences exist.  Therefore we recommend care be taken with
 -this upgrade and that testing should be greater than would be the case with a
 -minor point update.
 +The major change is that L<Plack>, a toolkit for using the L<PSGI>
- stack, now replaces most of the subclasses of L<Catalyst::Engine>. If
++specification, now replaces most of the subclasses of L<Catalyst::Engine>. If
 +you are using one of the standard subclasses of L<Catalyst::Engine> this
 +should be a straightforward upgrade for you. It was a design goal for
 +this release to preserve as much backwards compatibility as possible.
 +However, since L<Plack> is different from L<Catalyst::Engine>, it is
 +possible that differences exist for edge cases. Therefore, we recommend
 +that care be taken with this upgrade and that testing should be greater
 +than would be the case with a minor point update. Please inform the
 +Catalyst developers of any problems so that we can fix them and
 +incorporate tests.
  
  It is highly recommended that you become familiar with the L<Plack> ecosystem
  and documentation. Being able to take advantage of L<Plack> development and
@@@ -42,13 -38,16 +42,17 @@@ to use L<Catalyst::Script::FastCGI>
  
  =head2 Upgrading the mod_perl / Apache Engines
  
 -The engines that are build upon the various iterations of mod_perl,
 +The engines that are built upon the various iterations of mod_perl,
- L<Catalyst::Engine::Apache::MP13> and L<Catalyst::Engine::Apache2::MP20>,
- should be seamless upgrades and will work using using
- L<Plack::Handler::Apache1> or L<Plack::Handler::Apache2> as required.
+ L<Catalyst::Engine::Apache::MP13> (for mod_perl 1, and Apache 1.x) and
 -L<Catalyst::Engine::Apache2::MP20> (for mod_perl 2, and Apache 2.x)
++L<Catalyst::Engine::Apache2::MP20> (for mod_perl 2, and Apache 2.x),
+ should be seamless upgrades and will work using using L<Plack::Handler::Apache1>
+ or L<Plack::Handler::Apache2> as required.
  
 -L<Catalyst::Engine::Apache2::MP19>, is however no longer supported, as Plack
 -does not support mod_perl version 1.99. This is unlikely to be a problem
 -for anyone, as 1.99 was a brief beta-test release for mod_perl 2, and any users
 -are encouraged to upgrade to a supported release of Apache 2 and mod_perl 2.
 +L<Catalyst::Engine::Apache2::MP19>, however, is no longer supported, as
- Plack does not support mod_perl version 1.99
++Plack does not support mod_perl version 1.99. This is unlikely to be a
++problem for anyone, as 1.99 was a brief beta-test release for mod_perl
++2, and all users of mod_perl 1.99 are encouraged to upgrade to a
++supported release of Apache 2 and mod_perl 2.
  
  =head2 Upgrading the HTTP Engine