Deprecation section more complete, and link ::Upgrading
[catagits/Catalyst-Runtime.git] / lib / Catalyst / Delta.pod
1 =head1 Deltachanges from 5.7 to 5.8
2
3 This is an overview of the user visible changes in 5.8
4
5 =head2 Deprecations
6
7 Please see L<Catalyst::Upgrading> for a full description of how changes in the
8 framework may affect your application.
9
10 Below is a brief list of features which have been deprecated in this release:
11
12 =over
13
14 =item ::[MVC]:: style naming scheme has been deprecated and will warn
15
16 =item NEXT is deprecated for all applications and components, use MRO::Compat
17
18 =item Dispatcher methods which are an implementation detail made private, public versions now warn.
19
20 =item MyApp->plugin method is deprecated, use L<Catalyst::Model::Adaptor> instead.
21
22 =back
23
24 =head2 Dispatcher
25
26 Fix forwarding to Catalyst::Action objects (Rafael Kitover).
27
28 =head2 Restarter
29
30 The development server restarter has been improved to be compatible with
31 immutable Moose classes, and also to optionally use 
32 L<B::Hooks::OP::Check::StashChange> to handle more complex application layouts
33 correctly.
34
35 =head2 $c->uri_for_action method. (hdp)
36
37 A private path to the Catalyst action you want to create a URI for.
38 This is a shortcut for calling C<< $c->dispatcher->get_action_by_path($path) >>
39 and passing the resulting C<$action> and the remaining arguments to 
40 C<< $c->uri_for >>.
41
42 =head2 Logging
43
44 Log levels have been madeadditive, and add documentation to the setup_log 
45 method.
46
47 =head2 Consequences of the Moose backend
48
49 =over
50
51 =item *
52
53 Use MooseX::MethodAttributes::Inheritable to contain action
54 attributes. This means that attributes are now represented in the MOP,
55 allowing method modifiers on actions to work as expected. (rafl)
56
57 =item *
58
59 Provide a reasonable API in Catalyst::Controller for working with
60 and registering actions, allowing a controller sub-class to replace
61 subroutine attributes for action declerations with an alternate
62 syntax. (rafl/hdp)
63
64 =item *
65
66 Refactor capturing of $app from Catalyst::Controller into
67 Catalyst::Component::ApplicationAttribute for easier reuse in other
68 components (Florian Ragwitz)
69
70 =item *
71
72 Make MyApp immutable at the end of the scope after the setup
73 method is called, fixing issues with plugins which have their 
74 own new methods by inlining a constructor on MyApp (t0m)        
75
76 =back
77
78 =head2 Test Suite
79
80         - Change Catalyst::Test to use Sub::Exporter (Florian Ragwitz).
81         - Port to Moose
82         - Support mocking virtualhosts in test suite ()
83         - Add methods like action_ok and action_redirect to write
84           more compact tests
85
86 =head2 Catalyst::Response->print()
87
88 Prints @data to the output stream, separated by $,.  This lets you pass
89 the response object to functions that want to write to an L<IO::Handle>.
90