Example added to #Actions_in_your_application_class

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

diff --git a/lib/Catalyst/Upgrading.pod b/lib/Catalyst/Upgrading.pod
index 5cf2396..e0c3ee6 100644 (file)
--- a/lib/Catalyst/Upgrading.pod
+++ b/lib/Catalyst/Upgrading.pod
@@ -307,9 +307,38 @@ COMPONENT method in your @ISA.
 =head2 Actions in your application class
 
 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
+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:
+
+    package MyTest::Controller::Root;
+    
+    use strict;
+    use warnings;
+    
+    use parent 'Catalyst::Controller';
+    
+    __PACKAGE__->config(namespace => '');
+    
+    sub action : Local {
+        my ( $self, $c ) = @_;
+        $c->do_something; 
+    }
+    
+    1;
+
+=head2 ::[MVC]:: naming scheme
+
+Having packages called MyApp::[MVC]::XX is deprecated and can no longer be generated
+by catalyst.pl
+
+This is still supported, but it is recommended that you rename your application
+components to Model/View/Controller.
+
+A warning will be issued at application startup if the ::[MVC]:: naming scheme is
+in use.
 
 =head2 Catalyst::Base