From: Tomas Doran Date: Mon, 15 Aug 2011 21:11:36 +0000 (+0100) Subject: Move main synopsis of changes from changelog to Catalyst::Delta X-Git-Tag: 5.9000~1 X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=catagits%2FCatalyst-Runtime.git;a=commitdiff_plain;h=c20710a1059957ee276909e62f082d7256c2f378 Move main synopsis of changes from changelog to Catalyst::Delta --- diff --git a/Changes b/Changes index 3c2d211..c9323b3 100644 --- a/Changes +++ b/Changes @@ -2,54 +2,9 @@ 5.9000 - UNRELEASED - Major changes in this release: + See Catalyst::Delta for the major changes in this release. - The Catalyst::Engine classes have all been removed and deprecated, - to be replaced with Plack handlers. - - Plack is an implementation of the PSGI specification, which is - a standard interface between web servers and application frameworks. - - This should be no different for developers, and you should not have to - migrate your applications unless you are using a custom engine already. - - This change benefits Catalyst significantly by reducing the amount of - code inside the framework, and means that the framework gets upstream - bug fixes in Plack, and automatically gains support for any web server - which a PSGI compliant handler is written for. - - It also allows you more flexibility with your application, and allows - the use of cross web framework 'middleware'. - - Developers are recommended to read Catalyst::Upgrading for notes about - upgrading, especially if you are using an unusual deployment method. - - Documentation for how to take advantage of PSGI can be found in - Catalyst::PSGI, and information about deploying your application - has been moved to Catalyst::Manual::Deployment. - - A number of modules have been updated to pass their tests or not - produce deprecation warnings with the latest version of Catalyst. - It is recommended that you upgrade any of these that you are using - after installing this version of Catalyst. - - These extensions are: - - Catalyst::Engine::HTTP::Prefork - this is now deprecated, see - Catalyst::Upgrading. - - Test::WWW::Mechanize::Catalyst - has been updated to not produce - deprecation warnings. - - Catalyst::ActionRole::ACL - has been updated to fix failing tests - (although older versions still function perfectly with this - version of Catalyst). - - Catalyst::Plugin::Session::Store::DBIC - has been updated to fix - failing tests (although older versions still function perfectly - with this version of Catalyst). - - Changelong since the last TRIAL release: + Changelog since the last TRIAL release: Backward compatibility fixes: diff --git a/lib/Catalyst/Delta.pod b/lib/Catalyst/Delta.pod index 9880687..45235e1 100755 --- a/lib/Catalyst/Delta.pod +++ b/lib/Catalyst/Delta.pod @@ -4,13 +4,68 @@ Catalyst::Delta - Overview of changes between versions of Catalyst =head1 DESCRIPTION -This is an overview of the user-visible changes to Catalyst in version 5.9. +This is an overview of the user-visible changes to Catalyst between major Catalyst releases. -=head2 +=head2 VERSION 5.9XXX 'cataplack' + +The Catalyst::Engine sub-classes have all been removed and deprecated, +to be replaced with Plack handlers. + +Plack is an implementation of the L specification, which is +a standard interface between web servers and application frameworks. + +This should be no different for developers, and you should not have to +migrate your applications unless you are using a custom engine already. + +This change benefits Catalyst significantly by reducing the amount of +code inside the framework, and means that the framework gets upstream +bug fixes in L, and automatically gains support for any web server +which a L compliant handler is written for. + +It also allows you more flexibility with your application, and allows +the use of cross web framework 'middleware'. + +Developers are recommended to read L for notes about +upgrading, especially if you are using an unusual deployment method. + +Documentation for how to take advantage of L can be found in +L, and information about deploying your application +has been moved to L. + +=head3 Updated modules: + +A number of modules have been updated to pass their tests or not +produce deprecation warnings with the latest version of Catalyst. +It is recommended that you upgrade any of these that you are using +after installing this version of Catalyst. + +These extensions are: + +=over + +=item L + +This is now deprecated, see L. + +=item L + +Has been updated to not produce deprecation warnings, upgrade recommended. + +=item Catalyst::ActionRole::ACL + +Has been updated to fix failing tests (although older versions still +function perfectly with this version of Catalyst). + +=item Catalyst::Plugin::Session::Store::DBIC + +Has been updated to fix failing tests (although older versions still +function perfectly with this version of Catalyst). + +=back =head1 PREVIOUS VERSIONS -=head2 Catalyst 5.8 +=head2 VERSION 5.8XXX 'catamoose' =head3 Deprecations