Index: unix-sockets
===================================================================
--- unix-sockets	(revision 25894)
+++ unix-sockets	(working copy)
@@ -60,12 +60,20 @@
 
 Returns the pathname of the socket associated with the given listener object.
 
+<procedure>(unix-pair)</procedure>
+
+Create a pair of connected sockets and returns four values: an input-
+and output-port for the first socket, and the same for the second
+socket.  These ports can be used for bidirectional communication
+between a parent and child process, for example.
+
 === Gotchas
 
 If you try to write to the socket's output port when the other side has shut down the socket, a SIGPIPE will be generated. The application must handle or ignore the signal (see [[posix]]); once the signal is dealt with, the write attempt will raise an exception of its own using {{signal}} from [[Exceptions]].
 
 === Changelog
 
+* 1.7 Add {{unix-pair}}
 * 1.4 Do not import errno, to make it compatible with Chicken 4.1.0
 * 1.3 Applied bugfix by Shawn Wagner
 * 1.2 Added include for sys/time.h, which is needed on some systems [Thanks to Kon Lovett]