fixed spelling errors

[catagits/Catalyst-Runtime.git] / lib / Catalyst / PSGI.pod

diff --git a/lib/Catalyst/PSGI.pod b/lib/Catalyst/PSGI.pod
index 07590e7..13148ce 100644 (file)
--- a/lib/Catalyst/PSGI.pod
+++ b/lib/Catalyst/PSGI.pod
@@ -21,7 +21,7 @@ for specifics about your web server deployment).
 
 =head2 What is a .psgi file
 
-A C<< .psgi >> file lets you manually controll how your application code reference is built.
+A C<< .psgi >> file lets you manually control how your application code reference is built.
 
 Catalyst normally takes care of this for you, but it's possible to do it manually by
 creating a C<myapp.psgi> file in the root of your application.
@@ -36,7 +36,7 @@ The simplest C<.psgi> file for an application called C<TestApp> would be:
 
 It should be noted that Catalyst may apply a number of middleware components for
 you automatically, and these B<will not> be applied if you manually create
-a psgi file yourself. Details of these middlewares can be found XXXX FIXME
+a psgi file yourself. Details of these middlewares can be found below.
 
 Additional information about psgi files can be found at:
 L<http://search.cpan.org/dist/Plack/lib/Plack.pm#.psgi_files>
@@ -50,6 +50,30 @@ or L<Plack::Middleware::AccessLog>.
 
 =head2 What is in the .psgi Catalyst generates by default?
 
+Catalyst generates an application which, if the C<< using_frontend_proxy >>
+setting is on, is wrapped in L<Plack::Middleware::ReverseProxy>, and contains some
+engine specific fixes for uniform behaviour, as contained in:
+
+=over
+
+=item L<Plack::Middleware::LighttpdScriptNameFix>
+
+=item L<Plack::Middleware::IIS6ScriptNameFix>
+
+=item nginx - local to Catalyst
+
+=back
+
+If you override the default by providing your own C<< .psgi >> file, then
+none of these things will be done automatically for you by the PSGI
+application returned when you call C<< MyApp->psgi_app >>, and if you need
+any of this functionality, you'll need to implement this in your C<< .psgi >>
+file yourself.
+
+An apply_default_middlewares method is supplied to wrap your application
+in the default middlewares if you want this behaviour and you are providing
+your own .psgi file.
+
 =head1 SEE ALSO
 
 L<Catalyst::Upgrading>, L<Plack>, L<PSGI::FAQ>, L<PSGI>.