document io

R=rsc
DELTA=44  (30 added, 4 deleted, 10 changed)
OCL=25819
CL=25835
diff --git a/src/lib/io/pipe.go b/src/lib/io/pipe.go
index 6ef080f..427717b 100644
--- a/src/lib/io/pipe.go
+++ b/src/lib/io/pipe.go
@@ -169,7 +169,10 @@
 	w.Close();
 }
 
-// Create a synchronous in-memory pipe.
+// Pipe creates a synchronous in-memory pipe.
+// Used to connect code expecting an io.Read
+// with code expecting an io.Write.
+//
 // Reads on one end are matched by writes on the other.
 // Writes don't complete until all the data has been
 // written or the read end is closed.  Reads return