From: Volker Dobler <dr.volker.dobler@gmail.com>
Date: Mon, 6 Jan 2014 18:00:20 +0000 (-0800)
Subject: net/http/cookiejar: document format of domain in PublicSuffix
X-Git-Tag: go1.3beta1~1054
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=eb93f86275870bfe7d2b71d244df9ea87320e185;p=gostls13.git

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 389ab58e41..82f18a1784 100644
--- 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