finished first go at better control over closing writer
John Napiorkowski [Fri, 17 May 2013 16:58:11 +0000 (12:58 -0400)]
Changes
lib/Catalyst/Engine.pm
lib/Catalyst/Upgrading.pod

diff --git a/Changes b/Changes
index 115949c..1eaf0a9 100644 (file)
--- a/Changes
+++ b/Changes
@@ -1,7 +1,11 @@
 # This file documents the revision history for Perl extension Catalyst.
 
+TBA
   - Add Devel::InnerPackage to dependencies, fixing tests on perl 5.17.11
     as it's been removed from core. RT#84787
+  - New support for closing over the PSGI $writer object, useful for working
+    with event loops.
+
 
 5.90030 - 2013-04-12
   ! POSSIBLE BREAKING CHANGE: Removed Regexp dispatch type from core, and put
index b8d29a4..e63da83 100644 (file)
@@ -58,7 +58,7 @@ Finalize body.  Prints the response output as blocking stream if it looks like
 a filehandle, otherwise write it out all in one go.  If there is no body in
 the response, we assume you are handling it 'manually', such as for nonblocking
 style or asynchronous streaming responses.  You do this by calling L<\write>
-several times (which sends HTTP headers if needed) or you close over L<\write_fh>.
+several times (which sends HTTP headers if needed) or you close over C<$response->write_fh>.
 
 See L<Catalyst::Response\write> and L<Catalyst::Response\write_fh> for more.
 
index d1dd519..4526695 100644 (file)
@@ -2,15 +2,15 @@
 
 Catalyst::Upgrading - Instructions for upgrading to the latest Catalyst
 
-=head1 Upgrading to Catalyst 5.90040
+=head1 Upgrading to Catalyst TBA
 
 This version of L<Catalyst> offers some support for using L<AnyEvent> and
 L<IO::Async> event loops in your application.  These changes should work
 fine for most applications however if you are already trying to perform
 some streaming, minor changes in this area of the code might affect your
-functionality.
-
-  TDB: more on streaming, transfer encoding chunked, etc.
+functionality.  Please see L<Catalyst::Response\write_fh> for more and for a
+basic example.
 
 =head1 Upgrading to Catalyst 5.9