local-lib5/man/man3/Catalyst::Delta.3pm

   1 .\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.3
   2 .\"
   3 .\" Standard preamble:
   4 .\" ========================================================================
   5 .de Sh \" Subsection heading
   6 .br
   7 .if t .Sp
   8 .ne 5
   9 .PP
  10 \fB\\$1\fR
  11 .PP
  12 ..
  13 .de Sp \" Vertical space (when we can't use .PP)
  14 .if t .sp .5v
  15 .if n .sp
  16 ..
  17 .de Vb \" Begin verbatim text
  18 .ft CW
  19 .nf
  20 .ne \\$1
  21 ..
  22 .de Ve \" End verbatim text
  23 .ft R
  24 .fi
  25 ..
  26 .\" Set up some character translations and predefined strings.  \*(-- will
  27 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
  28 .\" double quote, and \*(R" will give a right double quote.  | will give a
  29 .\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
  30 .\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
  31 .\" expand to `' in nroff, nothing in troff, for use with C<>.
  32 .tr \(*W-|\(bv\*(Tr
  33 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
  34 .ie n \{\
  35 .    ds -- \(*W-
  36 .    ds PI pi
  37 .    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
  38 .    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
  39 .    ds L" ""
  40 .    ds R" ""
  41 .    ds C` ""
  42 .    ds C' ""
  43 'br\}
  44 .el\{\
  45 .    ds -- \|\(em\|
  46 .    ds PI \(*p
  47 .    ds L" ``
  48 .    ds R" ''
  49 'br\}
  50 .\"
  51 .\" If the F register is turned on, we'll generate index entries on stderr for
  52 .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
  53 .\" entries marked with X<> in POD.  Of course, you'll have to process the
  54 .\" output yourself in some meaningful fashion.
  55 .if \nF \{\
  56 .    de IX
  57 .    tm Index:\\$1\t\\n%\t"\\$2"
  58 ..
  59 .    nr % 0
  60 .    rr F
  61 .\}
  62 .\"
  63 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
  64 .\" way too many mistakes in technical documents.
  65 .hy 0
  66 .if n .na
  67 .\"
  68 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
  69 .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
  70 .    \" fudge factors for nroff and troff
  71 .if n \{\
  72 .    ds #H 0
  73 .    ds #V .8m
  74 .    ds #F .3m
  75 .    ds #[ \f1
  76 .    ds #] \fP
  77 .\}
  78 .if t \{\
  79 .    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
  80 .    ds #V .6m
  81 .    ds #F 0
  82 .    ds #[ \&
  83 .    ds #] \&
  84 .\}
  85 .    \" simple accents for nroff and troff
  86 .if n \{\
  87 .    ds ' \&
  88 .    ds ` \&
  89 .    ds ^ \&
  90 .    ds , \&
  91 .    ds ~ ~
  92 .    ds /
  93 .\}
  94 .if t \{\
  95 .    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
  96 .    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
  97 .    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
  98 .    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
  99 .    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
 100 .    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
 101 .\}
 102 .    \" troff and (daisy-wheel) nroff accents
 103 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
 104 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
 105 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
 106 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
 107 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
 108 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
 109 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
 110 .ds ae a\h'-(\w'a'u*4/10)'e
 111 .ds Ae A\h'-(\w'A'u*4/10)'E
 112 .    \" corrections for vroff
 113 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
 114 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
 115 .    \" for low resolution devices (crt and lpr)
 116 .if \n(.H>23 .if \n(.V>19 \
 117 \{\
 118 .    ds : e
 119 .    ds 8 ss
 120 .    ds o a
 121 .    ds d- d\h'-1'\(ga
 122 .    ds D- D\h'-1'\(hy
 123 .    ds th \o'bp'
 124 .    ds Th \o'LP'
 125 .    ds ae ae
 126 .    ds Ae AE
 127 .\}
 128 .rm #[ #] #H #V #F C
 129 .\" ========================================================================
 130 .\"
 131 .IX Title "Catalyst::Delta 3"
 132 .TH Catalyst::Delta 3 "2009-05-21" "perl v5.8.7" "User Contributed Perl Documentation"
 133 .SH "NAME"
 134 Catalyst::Delta \- Overview of changes between versions of Catalyst
 135 .SH "DESCRIPTION"
 136 .IX Header "DESCRIPTION"
 137 This is an overview of the user-visible changes to Catalyst in version 5.8.
 138 .Sh "Deprecations"
 139 .IX Subsection "Deprecations"
 140 Please see Catalyst::Upgrading for a full description of how changes in the
 141 framework may affect your application.
 142 .PP
 143 Below is a brief list of features which have been deprecated in this release:
 144 .IP "::[\s-1MVC\s0]:: style naming scheme has been deprecated and will warn" 4
 145 .IX Item "::[MVC]:: style naming scheme has been deprecated and will warn"
 146 .PD 0
 147 .IP "\s-1NEXT\s0 is deprecated for all applications and components, use MRO::Compat" 4
 148 .IX Item "NEXT is deprecated for all applications and components, use MRO::Compat"
 149 .IP "Dispatcher methods which are an implementation detail made private, public versions now warn." 4
 150 .IX Item "Dispatcher methods which are an implementation detail made private, public versions now warn."
 151 .IP "MyApp\->plugin method is deprecated, use Catalyst::Model::Adaptor instead." 4
 152 .IX Item "MyApp->plugin method is deprecated, use Catalyst::Model::Adaptor instead."
 153 .IP "_\|_PACKAGE_\|_\->\fImk_accessors()\fR is supported for backward compatibility only, use Moose attributes instead in new code." 4
 154 .IX Item "__PACKAGE__->mk_accessors() is supported for backward compatibility only, use Moose attributes instead in new code."
 155 .IP "Use of Catalyst::Base now warns" 4
 156 .IX Item "Use of Catalyst::Base now warns"
 157 .PD
 158 .Sh "New features"
 159 .IX Subsection "New features"
 160 \fIDispatcher\fR
 161 .IX Subsection "Dispatcher"
 162 .IP "Fix forwarding to Catalyst::Action objects." 4
 163 .IX Item "Fix forwarding to Catalyst::Action objects."
 164 .PD 0
 165 .IP "Add the dispatch_type method" 4
 166 .IX Item "Add the dispatch_type method"
 167 .PD
 168 .PP
 169 \fIRestarter\fR
 170 .IX Subsection "Restarter"
 171 .PP
 172 The development server restarter has been improved to be compatible with
 173 immutable Moose classes, and also to optionally use
 174 B::Hooks::OP::Check::StashChange to handle more complex application layouts
 175 correctly.
 176 .PP
 177 \fI$c\->uri_for_action method.\fR
 178 .IX Subsection "$c->uri_for_action method."
 179 .PP
 180 Give a private path to the Catalyst action you want to create a \s-1URI\s0 for.
 181 .PP
 182 \fILogging\fR
 183 .IX Subsection "Logging"
 184 .PP
 185 Log levels have been made additive.
 186 .PP
 187 \fICatalyst::Test\fR
 188 .IX Subsection "Catalyst::Test"
 189 .IP "Change to use Sub::Exporter." 4
 190 .IX Item "Change to use Sub::Exporter."
 191 .PD 0
 192 .IP "Support mocking multiple virtual hosts" 4
 193 .IX Item "Support mocking multiple virtual hosts"
 194 .IP "New methods like action_ok and action_redirect to write more compact tests" 4
 195 .IX Item "New methods like action_ok and action_redirect to write more compact tests"
 196 .PD
 197 .PP
 198 \fICatalyst::Response\fR
 199 .IX Subsection "Catalyst::Response"
 200 .IP "\(bu" 4
 201 New print method which prints \f(CW@data\fR to the output stream, separated by $,.
 202 This lets you pass the response object to functions that want to write to an
 203 IO::Handle.
 204 .IP "\(bu" 4
 205 Added code method as an alias for \f(CW\*(C`$res\->status\*(C'\fR
 206 .Sh "Consequences of the Moose back end"
 207 .IX Subsection "Consequences of the Moose back end"
 208 .IP "\(bu" 4
 209 Components are fully compatible with Moose, and all Moose features, such as
 210 method modifiers, attributes, roles, \s-1BUILD\s0 and \s-1BUILDARGS\s0 methods are fully
 211 supported and may be used in components and applications.
 212 .IP "\(bu" 4
 213 Many reusable extensions which would previously have been plugins or base
 214 classes are better implemented as Moose roles.
 215 .IP "\(bu" 4
 216 MooseX::MethodAttributes::Inheritable is used to contain action
 217 attributes. This means that attributes are represented in the \s-1MOP\s0, and
 218 decouples action creation from attributes.
 219 .IP "\(bu" 4
 220 There is a reasonable \s-1API\s0 in Catalyst::Controller for working with
 221 and registering actions, allowing a controller sub-class to replace
 222 subroutine attributes for action declarations with an alternate
 223 syntax.
 224 .IP "\(bu" 4
 225 Refactored capturing of \f(CW$app\fR from Catalyst::Controller into
 226 Catalyst::Component::ApplicationAttribute for easier reuse in other
 227 components.
 228 .IP "\(bu" 4
 229 Your application class is forced to become immutable at the end of compilation.
 230 .Sh "Bug fixes"
 231 .IX Subsection "Bug fixes"
 232 .IP "\(bu" 4
 233 Don't ignore \s-1SIGCHLD\s0 while handling requests with the development server, so that
 234 \&\fIsystem()\fR and other ways of creating child processes work as expected.
 235 .IP "\(bu" 4
 236 Fixes for FastCGI when used with \s-1IIS\s0 6.0
 237 .IP "\(bu" 4
 238 Fix a bug in uri_for which could cause it to generate paths with multiple
 239 slashes in them.
 240 .IP "\(bu" 4
 241 Fix a bug in Catalyst::Stats, stopping garbage being inserted into
 242 the stats if a user calls begin => but no end