X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=catagits%2FCatalyst-Runtime.git;a=blobdiff_plain;f=README;h=1438432076cc0a6c7b97ae639b564fab3ef33b87;hp=7278a8bf615d826405b2ffd0f69bfbae8277b52b;hb=gsoc_breadboard;hpb=92af75fc0533d5bea9c74b9ec64bdcacdf86f4bb diff --git a/README b/README index 7278a8b..1438432 100644 --- a/README +++ b/README @@ -1,114 +1,14 @@ -NAME - Catalyst - The Elegant MVC Web Application Framework +Catalyst-Runtime +================ +This is the Runtime distribution for the Catalyst MVC framework. +For more information about Catalyst, write -SYNOPSIS - # use the helper to start a new application - catalyst.pl MyApp - cd MyApp +$ perldoc Catalyst - # add models, views, controllers - script/create.pl model Something - script/create.pl view Stuff - script/create.pl controller Yada - - # built in testserver - script/server.pl - - # command line interface - script/test.pl /yada - - use Catalyst; - - use Catalyst qw/My::Module My::OtherModule/; - - use Catalyst '-Debug'; - - use Catalyst qw/-Debug -Engine=CGI/; - - __PACKAGE__->action( '!default' => sub { $_[1]->res->output('Hello') } ); - - __PACKAGE__->action( - 'index.html' => sub { - my ( $self, $c ) = @_; - $c->res->output('Hello'); - $c->forward('_foo'); - } - ); - - __PACKAGE__->action( - '/^product[_]*(\d*).html$/' => sub { - my ( $self, $c ) = @_; - $c->stash->{template} = 'product.tt'; - $c->stash->{product} = $c->req->snippets->[0]; - } - ); - - See also Catalyst::Manual::Intro - -DESCRIPTION - Catalyst is based upon Maypole, which you should consider for smaller - projects. - - The key concept of Catalyst is DRY (Don't Repeat Yourself). - - See Catalyst::Manual for more documentation. - - Omit the Catalyst::Plugin:: prefix from plugins. So - Catalyst::Plugin::My::Module becomes My::Module. - - use Catalyst 'My::Module'; - - You can also set special flags like -Debug and -Engine. - - use Catalyst qw/-Debug My::Module/; - - The position of plugins and flags in the chain is important, because - they are loaded in the same order they appear. - - -Debug - use Catalyst '-Debug'; - - is equivalent to - - use Catalyst; - sub debug { 1 } - - -Engine - Force Catalyst to use a specific engine. Omit the Catalyst::Engine:: - prefix. - - use Catalyst '-Engine=CGI'; - - METHODS - debug - Overload to enable debug messages. - - config - Returns a hashref containing your applications settings. - -SUPPORT - IRC: - - Join #catalyst on irc.perl.org. - - Mailing-Lists: - - http://lists.rawmode.org/mailman/listinfo/catalyst - http://lists.rawmode.org/mailman/listinfo/catalyst-dev - -SEE ALSO - Catalyst::Manual, Catalyst::Test, Catalyst::Request, Catalyst::Response, - Catalyst::Engine - -AUTHOR - Sebastian Riedel, "sri@oook.de" - -THANK YOU - Andrew Ruthven, Danijel Milicevic, David Naughton, Gary Ashton Jones, - Jesse Sheidlower, Johan Lindstrom, Marcus Ramberg and all the others - who've helped. - -LICENSE - This library is free software . You can redistribute it and/or modify it - under the same terms as perl itself. +at the command line, or visit http://www.catalystframework.org/. +You can also install Catalyst::Manual from CPAN for more +comprehensive information. +If you are going to write your own Catalyst application, you will +need to install Catalyst::Devel. Afterwards run catalyst.pl +for more information about creating your first app.