net/http/cookiejar: document format of domain in PublicSuffix

Document what values a PublicSuffixList must accept as
a domain in a call to PublicSuffix.

R=bradfitz, nigeltao
CC=golang-codereviews
https://golang.org/cl/47560044

diff --git a/src/pkg/net/http/cookiejar/jar.go b/src/pkg/net/http/cookiejar/jar.go
index 389ab58e4182f5d84c5d0fae15d974748e9cf4ee..82f18a178487cc89f5a977cf68ac736aa0a619d2 100644 (file)
--- a/src/pkg/net/http/cookiejar/jar.go
+++ b/src/pkg/net/http/cookiejar/jar.go
@@ -34,9 +34,9 @@ import (
 type PublicSuffixList interface {
        // PublicSuffix returns the public suffix of domain.
        //
-       // TODO: specify which of the caller and callee is responsible for IP
-       // addresses, for leading and trailing dots, for case sensitivity, and
-       // for IDN/Punycode.
+       // Domain is a lowercase punycoded domain name (not an IP address)
+       // without leading or trailing dots. The returned value is in the
+       // same form.
        PublicSuffix(domain string) string
 
        // String returns a description of the source of this public suffix