More info for #2653

doc/Type/IO/Handle.pod6

@@ -1104,7 +1104,10 @@ C<WRITE>, which stores every line in an element in an array. The C<read> method
 actually calls C<READ>, returning 3 bytes, which correspond to the three
 characters in the first two elements. Please note that it's the C<IO::Handle>
 base class the one that is taking care of cursor, since C<READ> just provides a
-handle into the whole content of the object.
+handle into the whole content of the object; the base class will C<READ> 1024 *
+1024 bytes at a time. If your object is planned to hold an amount of bytes
+bigger than that, you will have to handle an internal cursor yourself. That is
+why in this example we don't actually use the C<bytes> argument.
 
 =head2 method EOF
 
@@ -1116,7 +1119,8 @@ Indicates whether "end of file" has been reached for the B<data source> of the
 handle; i.e. no more data can be obtained by calling L<C«.READ»|/routine/READ>
 method. Note that this is B<not> the same as L<eof|/routine/eof> method, which
 will return C<True> only if C<.EOF> returns C<True> B<and all the decoder
-buffers>, if any were used by the handle, are also empty.
+buffers>, if any were used by the handle, are also empty. See
+L<C«.READ»|/routine/READ> for an example implementation.
 
 =head1 Related roles and classes