Document the '-|' open form in perlipc.pod

p4raw-id: //depot/perl@17276

diff --git a/pod/perlipc.pod b/pod/perlipc.pod
index 2df556f..0adfd44 100644 (file)
--- a/pod/perlipc.pod
+++ b/pod/perlipc.pod
@@ -570,6 +570,15 @@ And here's a safe pipe open for writing:
        # NOTREACHED
     }
 
+Since Perl 5.8.0, you can also use the list form of C<open> for pipes :
+the syntax
+
+    open KID_PS, "-|", "ps", "aux" or die $!;
+
+forks the ps(1) command (without spawning a shell, as there are more than
+three arguments to open()), and reads its standard output via the
+C<KID_PS> filehandle.
+
 Note that these operations are full Unix forks, which means they may not be
 correctly implemented on alien systems.  Additionally, these are not true
 multithreading.  If you'd like to learn more about threading, see the