X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperlapio.pod;h=68d794f66a9cb25e82fd4e645eb0a0b565014ddd;hb=14aaa8fc27b8350048cdee657c0128eb979d0b2a;hp=9da7f2d3d6e69da72f07ca8c377bff289a2dc13b;hpb=4b069b44f3c785593c10e7aca80c893a2f210b9d;p=p5sagit%2Fp5-mst-13.2.git

diff --git a/pod/perlapio.pod b/pod/perlapio.pod
index 9da7f2d..68d794f 100644
--- a/pod/perlapio.pod
+++ b/pod/perlapio.pod
@@ -321,6 +321,8 @@ C<PerlIO_close()> on the returned PerlIO *.
 The PerlIO is set to textmode. Use PerlIO_binmode if this is
 not the desired mode.
 
+This is B<not> the reverse of PerlIO_exportFILE().
+
 =item B<PerlIO_exportFILE(f,mode)>
 
 Given a PerlIO * create a 'native' FILE * suitable for passing to code
@@ -334,6 +336,7 @@ pushing a new :stdio "layer" onto the PerlIO *), which may affect future
 PerlIO operations on the original PerlIO *.
 You should not call C<fclose()> on the file unless you call
 C<PerlIO_releaseFILE()> to disassociate it from the PerlIO *.
+(Do not use PerlIO_importFILE() for doing the disassociation.)
 
 Calling this function repeatedly will create a FILE * on each call
 (and will push an :stdio layer each time as well).
@@ -344,6 +347,9 @@ Calling PerlIO_releaseFILE informs PerlIO that all use of FILE * is
 complete. It is removed from the list of 'exported' FILE *s, and the
 associated PerlIO * should revert to its original behaviour.
 
+Use this to disassociate a file from a PerlIO * that was associated
+using PerlIO_exportFILE().
+
 =item B<PerlIO_findFILE(f)>
 
 Returns a native FILE * used by a stdio layer. If there is none, it