document [ sub {} ]
Danijel Tasov [Thu, 8 Dec 2011 14:53:32 +0000 (15:53 +0100)]
Signed-off-by: Danijel Tasov <dt@korn.shell.la>

lib/Web/Simple.pm

index 70bb97f..82b8ba7 100644 (file)
@@ -198,6 +198,17 @@ However, generally, instead of that, you return a set of dispatch subs:
     ...
   }
 
+Well, a sub is a valid PSGI response too (for ultimate streaming and async
+cleverness). If you want to return a PSGI sub you have to wrap it into an
+array ref.
+
+  sub dispatch_request {
+    [ sub { 
+        my $respond = shift;
+        # This is pure PSGI here, so read perldoc PSGI
+    } ]
+  }
+
 If you return a subroutine with a prototype, the prototype is treated
 as a match specification - and if the test is passed, the body of the
 sub is called as a method any matched arguments (see below for more details).