Move main synopsis of changes from changelog to Catalyst::Delta

diff --git a/Changes b/Changes
index 3c2d211..c9323b3 100644 (file)
--- 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 (executable)
--- 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<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 L<Plack>, and automatically gains support for any web server
+which a L<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 L<Catalyst::Upgrading> for notes about
+upgrading, especially if you are using an unusual deployment method.
+
+Documentation for how to take advantage of L<PSGI> can be found in
+L<Catalyst::PSGI>, and information about deploying your application
+has been moved to L<Catalyst::Manual::Deployment>.
+
+=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<Catalyst::Engine::HTTP::Prefork>
+
+This is now deprecated, see L<Catalyst::Upgrading>.
+
+=item L<Test::WWW::Mechanize::Catalyst>
+
+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