X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FCatalyst%2FManual%2FInternals.pod;h=0c2c33d61f426ea2ae05339c8f7dc5a958e77b34;hb=8fbcd90cdb30aed53d22d1cdbad95880f1c11693;hp=ae8e9f93a9f665350dfb276f807731abca8c54d1;hpb=06e1b6164a2c9d7b463f358b0d1934ef83a82845;p=catagits%2FCatalyst-Runtime.git

diff --git a/lib/Catalyst/Manual/Internals.pod b/lib/Catalyst/Manual/Internals.pod
index ae8e9f9..0c2c33d 100644
--- a/lib/Catalyst/Manual/Internals.pod
+++ b/lib/Catalyst/Manual/Internals.pod
@@ -4,12 +4,13 @@ Catalyst::Manual::Internals - Catalyst Internals
 
 =head1 DESCRIPTION
 
-This document provides an overview of the internals of Catalyst.  As Catalyst
-is still developing rapidly details may become out of date.
+This document provides an overview of the internals of
+Catalyst.  As Catalyst is still developing rapidly, details
+may become out of date: please treat this as a guide, and
+look at the source for the last word.
 
 The coverage is split into initialization and request lifecycle.
 
-
 =head2 Initialization
 
 Catalyst initializes itself in two stages (I may be wrong in some of
@@ -19,18 +20,19 @@ the details here - AF):
 
 =item 1
 
-When the Catalyst module is imported in the main application module it
-evaluates any options (C<-Debug>, C<-Engine=XXX>) and loads any specified
-plugins, making application module inherit from the plugin classes.  It also
-sets up a default log object and ensures that the application module inherits
-from C<Catalyst> and from the selected specialized Engine module.
+When the Catalyst module is imported in the main application
+module it evaluates any options (C<-Debug>, C<-Engine=XXX>)
+and loads any specified plugins, making the application module
+inherit from the plugin classes. It also sets up a default log
+object and ensures that the application module inherits from
+C<Catalyst> and from the selected specialized Engine module.
 
 =item 2
 
 When the application module makes the first call to C<< __PACKAGE__->action() >>
-(implemented in C<Catalyst::Engine>) Catalyst automatically loads all
-components it finds in the C<$class\::Controller>, C<$class\::C>,
-C<$class\::Model>, C<$class\::M>, C<$class\::View> and C<$class\::V>
+(implemented in C<Catalyst::Engine>), Catalyst automatically loads all
+components it finds in the C<$class::Controller>, C<$class::C>,
+C<$class::Model>, C<$class::M>, C<$class::View> and C<$class::V>
 namespaces (using C<Module::Pluggable::Fast>).  A table of actions is built up
 and added to on subsequent calls to C<action()>.
 
@@ -40,7 +42,7 @@ and added to on subsequent calls to C<action()>.
 =head2 Request Lifecycle
 
 For each request Catalyst builds a I<context> object, which includes
-information about the request, and searches the action table for matching
+information about the request, and then searches the action table for matching
 actions.  
 
 The handling of a request can be divided into three stages: preparation of the
@@ -51,10 +53,10 @@ extend Catalyst.
     handler
       prepare
         prepare_request
-        prepare_path
+        prepare_connection
         prepare_headers
         prepare_cookies
-        prepare_connection
+        prepare_path
         prepare_action
         prepare_body
         prepare_parameters