From: Peter Prymmer Date: Mon, 29 Jan 2001 16:46:25 +0000 (-0800) Subject: pod problems in io X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=11e1c8f2799d09ead03e234a9f91269f8b6b179b;p=p5sagit%2Fp5-mst-13.2.git pod problems in io Message-ID: p4raw-id: //depot/perl@8593 --- diff --git a/pod/perlapio.pod b/pod/perlapio.pod index 6f0c96c..06e3d14 100644 --- a/pod/perlapio.pod +++ b/pod/perlapio.pod @@ -136,7 +136,7 @@ There may be an implementation limit on the number of open handles, which may be lower than the limit on the number of open files - C may not be set when C is returned if this limnit is exceeded. -=item B While this currently exists in all three implementations perl itself does not use it. I @@ -389,7 +389,7 @@ Do not use this - use PerlIO_fast_gets. 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". @@ -433,9 +433,9 @@ B is perl's charcter for the kind of IO: =over 8 -=item '<' read +=item 'E' read -=item '>' write +=item 'E' write =item '+' read/write @@ -468,7 +468,6 @@ recursively call PerlIO and be a problem. 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 diff --git a/pod/perliol.pod b/pod/perliol.pod index fc8f923..ac6a4a2 100644 --- a/pod/perliol.pod +++ b/pod/perliol.pod @@ -62,8 +62,8 @@ scalar's type changes.) An IO stream is then in general represented as a pointer to this linked-list of "layers". It should be noted that because of the double indirection in a C, -a C<< &(perlio->next) >> "is" a C, and so to some degree at least -one layer can use the "standard" API on the next layer down. +a C<< &(perlio-Enext) >> "is" a C, 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: @@ -246,9 +246,9 @@ All writes should be appends. =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 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 will mess with this flag rather than add/remove layers if the C bit is set for the layers class.