Skip to content

Commit

Permalink
Some linting, and fixed wrong FAQ explanation about streaming/nonbloc…
Browse files Browse the repository at this point in the history
…king
  • Loading branch information
miyagawa committed Jan 6, 2010
1 parent c5aa24f commit 5589b64
Show file tree
Hide file tree
Showing 2 changed files with 4 additions and 6 deletions.
6 changes: 3 additions & 3 deletions PSGI.pod
Original file line number Diff line number Diff line change
Expand Up @@ -433,7 +433,7 @@ This interface B<SHOULD> be implemented by PSGI servers, and
C<psgi.streaming> environment B<MUST> be set to true in such servers.

To enable a delayed response, the application B<SHOULD> return a
callback as its response. An application B<MAY>check if the
callback as its response. An application B<MAY> check if the
C<psgi.streaming> environment is true and falls back to the direct
response if it isn't.

Expand Down Expand Up @@ -482,8 +482,8 @@ methods. Again, an example illustrates this best.

This delayed response and streaming API is useful if you want to
implement a non-blocking I/O based server streaming or long-poll Comet
push technology, but could also be used to write unbuffered write in a
blocking server.
push technology, but could also be used to implement unbuffered writes
in a blocking server.

=head2 Middleware

Expand Down
4 changes: 1 addition & 3 deletions PSGI/FAQ.pod
Original file line number Diff line number Diff line change
Expand Up @@ -458,9 +458,7 @@ C<wait_for_new_message> can be blocking or non-blocking: it's up to
you. Most of the case you want to run it non-blockingly and should use
event loops like L<AnyEvent>. You may also check C<psgi.nonblocking>
value to see that it's possible and fallback to a blocking call
otherwise to be compatible with non streaming capable servers, but
you're not required to, since it's defined as SHOULD in the
specification now.
otherwise.

Also, to stream the content body (like streaming messages over the
Flash socket or multipart XMLHTTPRequest):
Expand Down

0 comments on commit 5589b64

Please sign in to comment.