be lower than the limit on the number of open files - C<errno> may
not be set when C<NULL> is returned if this limnit is exceeded.
-=item B<PerlIO_reopen(path,mode,f)
+=item B<PerlIO_reopen(path,mode,f)>
While this currently exists in all three implementations perl itself
does not use it. I<As perl does not use it, it is not well tested.>
Obscure - set count of bytes in the buffer. Deprecated.
Only usable if PerlIO_canset_cnt() returns true.
-Currently used in only doio.c to force count < -1 to -1.
+Currently used in only doio.c to force count less than -1 to -1.
Perhaps should be PerlIO_set_empty or similar.
This call may actually do nothing if "count" is deduced from pointer
and a "limit".
=over 8
-=item '<' read
+=item 'E<lt>' read
-=item '>' write
+=item 'E<gt>' write
=item '+' read/write
PerlIO_debug writes to the file named by $ENV{'PERLIO_DEBUG'} typical use
might be
-
Bourne shells:
PERLIO_DEBUG=/dev/tty ./perl somescript some args
pointer to this linked-list of "layers".
It should be noted that because of the double indirection in a C<PerlIO *>,
-a C<< &(perlio->next) >> "is" a C<PerlIO *>, and so to some degree at least
-one layer can use the "standard" API on the next layer down.
+a C<< &(perlio-E<gt>next) >> "is" a C<PerlIO *>, and so to some degree
+at least one layer can use the "standard" API on the next layer down.
A "layer" is composed of two parts:
=item PERLIO_F_CRLF
-Layer is performing Win32-like "\n" => CR,LF for output and CR,LF =>
-"\n" for input. Normally the provided "crlf" layer is the only layer
-that need bother about this. C<PerlIO_binmode()> will mess with this
+Layer is performing Win32-like "\n" mapped to CR,LF for output and CR,LF
+mapped to "\n" for input. Normally the provided "crlf" layer is the only
+layer that need bother about this. C<PerlIO_binmode()> will mess with this
flag rather than add/remove layers if the C<PERLIO_K_CANCRLF> bit is set
for the layers class.