From: Lupe Christoph Date: Thu, 9 May 2002 09:01:50 +0000 (+0200) Subject: [Patch] perlapio.pod X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=65dabbe3286e79f63edd4b43d9a84f46860dc2bc;p=p5sagit%2Fp5-mst-13.2.git [Patch] perlapio.pod Message-Id: <20020509070150.GI1087@lupe-christoph.de> (Applied with tweaks.) p4raw-id: //depot/perl@16513 --- diff --git a/pod/perlapio.pod b/pod/perlapio.pod index a0e4ffa..0597687 100644 --- a/pod/perlapio.pod +++ b/pod/perlapio.pod @@ -309,13 +309,12 @@ Used to get a PerlIO * from a FILE *. The flags argument was meant to be used for read vs write vs read/write information. In hindsight it would have been better to make -it a char *mode as in fopen/freopen. Flags arecurrently ignored, and +it a char *mode as in fopen/freopen. Flags are currently ignored, and code attempts to empirically determine the mode in which I is open. Once called the FILE * should I be closed by calling C on the returned PerlIO *. - =item B Given a PerlIO * create a 'native' FILE * suitable for passing to code @@ -329,7 +328,7 @@ The fact that such a FILE * has been 'exported' is recorded, (normally by pushing a new :stdio "layer" onto the PerlIO *), which may affect future PerlIO operations on the original PerlIO *. You should not call C on the file unless you call -C to disassociate it from the the PerlIO *. +C to disassociate it from the PerlIO *. Calling this function repeatedly will create a FILE * on each call (and will push an :stdio layer each time as well). @@ -337,14 +336,14 @@ Calling this function repeatedly will create a FILE * on each call =item B Calling PerlIO_releaseFILE informs PerlIO that all use of FILE * is -complete. It is removed from list of 'exported' FILE *s, and -associated PerlIO * should revert to original behaviour. +complete. It is removed from the list of 'exported' FILE *s, and the +associated PerlIO * should revert to its original behaviour. =item B Returns a native FILE * used by a stdio layer. If there is none, it will create one with PerlIO_exportFILE. In either case the FILE * -should be considered at belonging to PerlIO subsystem and should +should be considered as belonging to PerlIO subsystem and should only be closed by calling C.