Add info about TT debug flags.
[catagits/Catalyst-Runtime.git] / lib / Catalyst / ActionContainer.pm
index 14a2fcc..570a0cd 100644 (file)
@@ -12,6 +12,14 @@ use overload (
 
 );
 
+sub new {
+    my ( $class, $fields ) = @_;
+
+    $fields = { part => $fields, actions => {} } unless ref $fields;
+
+    $class->SUPER::new($fields);
+}
+
 =head1 NAME
 
 Catalyst::ActionContainer - Catalyst Action Container
@@ -22,25 +30,43 @@ See L<Catalyst>.
 
 =head1 DESCRIPTION
 
+This is a container for actions. The dispatcher sets up a tree of these
+to represent the various dispatch points in your application.
+
 =head1 METHODS
 
-=over 4
+=head2 get_action($name)
 
-=item get_action
+Returns an action from this container based on the action name, or undef
 
 =cut
 
 sub get_action {
-    my ( $self, $c, $name ) = @_;
+    my ( $self, $name ) = @_;
     return $self->actions->{$name} if defined $self->actions->{$name};
     return;
 }
 
-=item actions
+=head2 add_action($action, [ $name ])
+
+Adds an action, optionally providing a name to override $action->name
+
+=cut
+
+sub add_action {
+    my ( $self, $action, $name ) = @_;
+    $name ||= $action->name;
+    $self->actions->{$name} = $action;
+}
+
+=head2 actions
+
+Accessor to the actions hashref, containing all actions in this container.
 
-=item part
+=head2 part
 
-=back
+Accessor to the path part this container resolves to. Also what the container
+stringifies to.
 
 =head1 AUTHOR