From: Mikio Hara <mikioh.mikioh@gmail.com>
Date: Fri, 29 Mar 2013 03:16:24 +0000 (+0900)
Subject: net: update documentation for FileConn, FilePacketConn, FileListener
X-Git-Tag: go1.1rc2~278
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=abccf6b692cbe6585839bbbea9c040f4d191114e;p=gostls13.git

net: update documentation for FileConn, FilePacketConn, FileListener

Closes the API documentation gap between platforms.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/8086043
---

diff --git a/src/pkg/net/file_windows.go b/src/pkg/net/file_windows.go
index c50c32e210..ca2b9b2262 100644
--- a/src/pkg/net/file_windows.go
+++ b/src/pkg/net/file_windows.go
@@ -9,16 +9,28 @@ import (
 	"syscall"
 )
 
+// FileConn returns a copy of the network connection corresponding to
+// the open file f.  It is the caller's responsibility to close f when
+// finished.  Closing c does not affect f, and closing f does not
+// affect c.
 func FileConn(f *os.File) (c Conn, err error) {
 	// TODO: Implement this
 	return nil, os.NewSyscallError("FileConn", syscall.EWINDOWS)
 }
 
+// FileListener returns a copy of the network listener corresponding
+// to the open file f.  It is the caller's responsibility to close l
+// when finished.  Closing l does not affect f, and closing f does not
+// affect l.
 func FileListener(f *os.File) (l Listener, err error) {
 	// TODO: Implement this
 	return nil, os.NewSyscallError("FileListener", syscall.EWINDOWS)
 }
 
+// FilePacketConn returns a copy of the packet network connection
+// corresponding to the open file f.  It is the caller's
+// responsibility to close f when finished.  Closing c does not affect
+// f, and closing f does not affect c.
 func FilePacketConn(f *os.File) (c PacketConn, err error) {
 	// TODO: Implement this
 	return nil, os.NewSyscallError("FilePacketConn", syscall.EWINDOWS)