Fix #12.

cache.go

@@ -8,7 +8,7 @@ import (
 	"time"
 )
 
-// NewCachingResolver creates a caching net.Resolver that uses parent to resolve names.
+// NewCachingResolver creates a caching [net.Resolver] that uses parent to resolve names.
 func NewCachingResolver(parent *net.Resolver, options ...CacheOption) *net.Resolver {
 	if parent == nil {
 		parent = &net.Resolver{}
@@ -55,7 +55,7 @@ func (o minTTLOption) apply(c *cache)        { c.minTTL = time.Duration(o) }
 func (o negativeCacheOption) apply(c *cache) { c.negative = bool(o) }
 
 // MaxCacheEntries sets the maximum number of entries to cache.
-// If zero, DefaultMaxCacheEntries is used; negative means no limit.
+// If zero, [DefaultMaxCacheEntries] is used; negative means no limit.
 func MaxCacheEntries(n int) CacheOption { return maxEntriesOption(n) }
 
 // MaxCacheTTL sets the maximum time-to-live for entries in the cache.

dns.go

@@ -1,7 +1,7 @@
-// Package dns provides net.Resolver instances implementing caching,
+// Package dns provides [net.Resolver] instances implementing caching,
 // opportunistic encryption, and DNS over TLS/HTTPS.
 //
-// To replace the net.DefaultResolver with a caching DNS over HTTPS instance
+// To replace the [net.DefaultResolver] with a caching DNS over HTTPS instance
 // using the Google Public DNS resolver:
 //
 //	net.DefaultResolver = dns.NewDoHResolver(

doh.go

@@ -72,8 +72,7 @@ func NewDoHResolver(uri string, options ...DoHOption) (*net.Resolver, error) {
 
 	// create the resolver
 	var resolver = net.Resolver{
-		PreferGo:     true,
-		StrictErrors: true,
+		PreferGo: true,
 		Dial: func(ctx context.Context, network, address string) (net.Conn, error) {
 			conn := &dnsConn{}
 			conn.roundTrip = dohRoundTrip(uri, &client)
@@ -89,7 +88,6 @@ func NewDoHResolver(uri string, options ...DoHOption) (*net.Resolver, error) {
 		conn, err := d.DialContext(ctx, network, opts.addrs[i])
 		if err != nil {
 			index.CompareAndSwap(i, (i+1)%uint32(len(opts.addrs)))
-			return nil, err
 		}
 		return conn, err
 	}
@@ -102,7 +100,7 @@ func NewDoHResolver(uri string, options ...DoHOption) (*net.Resolver, error) {
 	return &resolver, nil
 }
 
-// An DoHOption customizes the DNS over HTTPS resolver.
+// A DoHOption customizes the DNS over HTTPS resolver.
 type DoHOption interface {
 	apply(*dohOpts)
 }

dot.go

@@ -61,10 +61,7 @@ func NewDoTResolver(server string, options ...DoTOption) (*net.Resolver, error)
 	}
 
 	// create the resolver
-	var resolver = net.Resolver{
-		PreferGo:     true,
-		StrictErrors: true,
-	}
+	var resolver = net.Resolver{PreferGo: true}
 
 	// setup dialer
 	var index atomic.Uint32