X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FCatalyst%2FUpgrading.pod;h=78a6d6c6e5bdec8a8931cdbd63b903e1923f6684;hb=8566c0de7c243b0ba1555e321759ca74bc1c05db;hp=e2d49fa127c6042ab01cb1c9b6e727f68569ce04;hpb=6c04a1eadc9d788231680a9ae7bff50d448899a3;p=catagits%2FCatalyst-Runtime.git

diff --git a/lib/Catalyst/Upgrading.pod b/lib/Catalyst/Upgrading.pod
index e2d49fa..78a6d6c 100644
--- a/lib/Catalyst/Upgrading.pod
+++ b/lib/Catalyst/Upgrading.pod
@@ -3,7 +3,7 @@
 Most applications and plugins should run unaltered on Catalyst 5.80.
 
 However as a lot of refactoring work has taken place, several changes
-have been made which could cause incompatibilties, if your application
+have been made which could cause incompatibilities, if your application
 or plugin is using deprecated code, or relying on side-effects then
 there could be incompatibility.
 
@@ -24,9 +24,19 @@ Moose components for Catalyst 5.70 needed to do
     extends qw/Moose::Object Catalyst::Component/;
 
 to be able to use the constructor provided by Moose. In 5.80
-C<Catalyst::Component> already inherits from C<Moose::Object>. Therefor you
+C<Catalyst::Component> already inherits from C<Moose::Object>. Therefore you
 shouldn't directly inherit from C<Moose::Object> yourself, otherwise your
-Class' @ISA will not linearise with C3.
+Class' @ISA will not linearize with C3.
+
+You will also see this issue if you do the following:
+
+    use Moose; 
+    use base 'Catalyst::Controller';
+
+as C< use base > appends to @ISA.
+
+FIXME - Add note about the appropriate magic to detect $Catalyst::VERSION
+and work around it at compile time.
 
 =head2 Anonymous closures installed directly into the symbol table
 
@@ -85,7 +95,7 @@ by calling the mk_accessors class method.
 This is no longer supported - users should make a sub-class of the class who's behavior they would
 like to change, rather than globally polluting the Catalyst objects.
 
-=head2 Confused multiple inheritence with Catalyst::Component::COMPONENT
+=head2 Confused multiple inheritance with Catalyst::Component::COMPONENT
 
 Warning message:
 
@@ -107,7 +117,14 @@ the first COMPONENT method in your @ISA.
 
 =head2 Assigning lists to accessors
 
-FIXME
+Accessors generated by Class::Accessor::Fast will, when multiple values
+are assigned to them, store a reference to a list automatically for you.
+
+This is not currently supported by MooseX::Emulate::Class::Accessor::Fast,
+and only the first value in the list will be stored.
+
+If you are relying on this behavior, and inheriting mk_accessors from a
+Catalyst component, then your code will fail.
 
 =head1 WARNINGS
 
@@ -149,7 +166,7 @@ better API should look like.
 In this version of Catalyst, if a component is loaded from disk, but no symbols are defined in that component's namespace
 after it is loaded, this warning will be issued.
 
-This is to pretect against confusing bugs caused by mis-typing package names.
+This is to protect against confusing bugs caused by mis-typing package names.
 
 This will become a fatal error in a future version.