[Catalyst-commits] r12855 - Catalyst-Runtime/5.80/trunk/lib

[t0m at dev.catalyst.perl.org]

Author: t0m
Date: 2010-02-11 20:36:22 +0000 (Thu, 11 Feb 2010)
New Revision: 12855

Modified:
   Catalyst-Runtime/5.80/trunk/lib/Catalyst.pm
Log:
First attempt to make this make more sense.

Modified: Catalyst-Runtime/5.80/trunk/lib/Catalyst.pm
===================================================================
--- Catalyst-Runtime/5.80/trunk/lib/Catalyst.pm	2010-02-11 20:06:15 UTC (rev 12854)
+++ Catalyst-Runtime/5.80/trunk/lib/Catalyst.pm	2010-02-11 20:36:22 UTC (rev 12855)
@@ -1182,24 +1182,21 @@
     return 1; # Explicit return true as people have __PACKAGE__->setup as the last thing in their class. HATE.
 }
 
-
 =head2 $app->setup_finalize
 
-A hook to attach modifiers to.
-Using C<< after setup => sub{}; >> doesn't work, because of quirky things done for plugin setup.
-Also better than C< setup_finished(); >, as that is a getter method.
+A hook to attach modifiers to. This method does not do anything except set the
+C<setup_finished> accessor.
 
-    sub setup_finalize {
+Applying method modifiers to the C<setup> method doesn't work, because of quirky thingsdone for plugin setup.
 
+Example:
+
+    after setup_finalize => sub {
         my $app = shift;
 
-        ## do stuff, i.e., determine a primary key column for sessions stored in a DB
+        ## do stuff here..
+    };
 
-        $app->next::method(@_);
-
-
-    }
-
 =cut
 
 sub setup_finalize {