net: document sockaddr interface

This is in preparation for runtime-integrated network pollster for BSD
variants.

Update #5199

R=golang-dev, fvbommel, dave
CC=golang-dev
https://golang.org/cl/11984043

1 files changed, 15 insertions, 0 deletions

diff --git a/src/pkg/net/sock_posix.go b/src/pkg/net/sock_posix.go
index 1d238c9684..845428aa48 100644
--- a/src/pkg/net/sock_posix.go
+++ b/src/pkg/net/sock_posix.go
@@ -15,9 +15,24 @@ import (
 // address that can be converted into a syscall.Sockaddr.
 type sockaddr interface {
 	Addr
+
+	// family returns the platform-dependent address family
+	// identifier.
 	family() int
+
+	// isWildcard reports whether the address is a wildcard
+	// address.
 	isWildcard() bool
+
+	// sockaddr returns the address converted into a syscall
+	// sockaddr type that implements syscall.Sockaddr
+	// interface. It returns a nil interface when the address is
+	// nil.
 	sockaddr(family int) (syscall.Sockaddr, error)
+
+	// toAddr returns the address represented in sockaddr
+	// interface. It returns a nil interface when the address is
+	// nil.
 	toAddr() sockaddr
 }