Add just a little bit more explanation to PerlIO::encoding.

p4raw-id: //depot/perl@15967

diff --git a/ext/PerlIO/encoding/encoding.pm b/ext/PerlIO/encoding/encoding.pm
index b29373e..63df000 100644 (file)
--- a/ext/PerlIO/encoding/encoding.pm
+++ b/ext/PerlIO/encoding/encoding.pm
@@ -12,10 +12,19 @@ PerlIO::encoding - encoding layer
 
 =head1 SYNOPSIS
 
-   open($fh,"<...",\$scalar);
+   open($fh, "<",  \$scalar);
+   open($fh, ">",  \$scalar);
+   open($fh, ">>", \$scalar);
+
+   open($fh, "<...",  \$scalar); # for example open($fh, "<:crlf", \$scalar);
+   open($fh, ">...",  \$scalar); # for example open($fh, ">:utf8", \$scalar);
+   open($fh, ">>..",  \$scalar);
 
 =head1 DESCRIPTION
 
+Open scalars for "in memory" input and output.  The scalars will
+behave as if they were files.
+
 =cut