Permalink
Browse files

Added a note about read() built-in

  • Loading branch information...
1 parent ff0e6de commit e764e4f8e00c05718e1d26dc4b582beeaeb9f840 @miyagawa miyagawa committed Sep 7, 2009
Showing with 6 additions and 0 deletions.
  1. +6 −0 PSGI.pod
View
@@ -192,6 +192,12 @@ The built-in filehandle or IO::Handle based objects should work fine
everywhere. Application developers SHOULD NOT inspect the type or
class of the stream, but instead just call C<read> to duck type.
+Application developers SHOULD NOT use the built-in C<read> function to
+read from the input stream, because C<read> function only works with
+the real IO object (glob ref based file handle or PerlIO) and makes
+the duck typing difficult. Server implementors MAY, but are not
+required to, use PerlIO to work around with this problem.
+
=over 4
=item read

0 comments on commit e764e4f

Please sign in to comment.