-'''iocp tries to mimic Go's io.Copy function (http://golang.org/pkg/io/#Copy)
-which copies from everything that is an io.Reader to anything that is an
+'''iocp tries to mimic Go's `io.Copy`_ function which copies from everything
+that is an io.Reader to anything that is an io.Writer.
The Python world of things is not that organized, so iocp.copy will try to do a
best guess about which are the right function to call when reading and writing.
with open('/path/to/file') as fo:
+.. _`io.Copy`: http://golang.org/pkg/io/#Copy