ipv6: update package documentaton

Change-Id: I52df24a3128bf6ba5ef82a66fe8b7305f6cc0549
Reviewed-on: https://go-review.googlesource.com/2796
Reviewed-by: Ian Lance Taylor <iant@golang.org>

ipv6/control.go

@@ -17,21 +17,6 @@ var (
 	errNoSuchInterface = errors.New("no such interface")
 )
 
-// References:
-//
-// RFC 2292  Advanced Sockets API for IPv6
-//	http://tools.ietf.org/html/rfc2292
-// RFC 2460  Internet Protocol, Version 6 (IPv6) Specification
-//	http://tools.ietf.org/html/rfc2460
-// RFC 3493  Basic Socket Interface Extensions for IPv6
-//	http://tools.ietf.org/html/rfc3493.html
-// RFC 3542  Advanced Sockets Application Program Interface (API) for IPv6
-//	http://tools.ietf.org/html/rfc3542
-// RFC 3678  Socket Interface Extensions for Multicast Source Filters
-//	http://tools.ietf.org/html/rfc3678
-// RFC 4607  Source-Specific Multicast for IP
-//	http://tools.ietf.org/html/rfc4607
-//
 // Note that RFC 3542 obsoletes RFC 2292 but OS X Snow Leopard and the
 // former still support RFC 2292 only.  Please be aware that almost
 // all protocol implementations prohibit using a combination of RFC

ipv6/doc.go

@@ -6,9 +6,15 @@
 // Protocol version 6.
 //
 // The package provides IP-level socket options that allow
-// manipulation of IPv6 facilities.  The IPv6 and socket options for
-// IPv6 are defined in RFC 2460, RFC 3493, RFC 3542, RFC 3678 and RFC
-// 4607.
+// manipulation of IPv6 facilities.
+//
+// The IPv6 protocol is defined in RFC 2460.
+// Basic and advanced socket interface extensions are defined in RFC
+// 3493 and RFC 3542.
+// Socket interface extensions for multicast source filters are
+// defined in RFC 3678.
+// MLDv1 and MLDv2 are defined in RFC 2710 and RFC 3810.
+// Source-specific multicast is defined in RFC 4607.
 //
 //
 // Unicasting
@@ -196,8 +202,8 @@
 // Source-specific multicasting
 //
 // An application that uses PacketConn on MLDv2 supported platform is
-// able to join source-specific multicast groups as described in RFC
-// 3678.  The application may use JoinSourceSpecificGroup and
+// able to join source-specific multicast groups.
+// The application may use JoinSourceSpecificGroup and
 // LeaveSourceSpecificGroup for the operation known as "include" mode,
 //
 //	ssmgroup := net.UDPAddr{IP: net.ParseIP("ff32::8000:9")}