]> Cypherpunks repositories - gostls13.git/commitdiff
doc/go1.19: document Resolver.PreferGo
authorBrad Fitzpatrick <bradfitz@golang.org>
Sat, 4 Jun 2022 04:18:14 +0000 (21:18 -0700)
committerGopher Robot <gobot@golang.org>
Mon, 6 Jun 2022 19:53:39 +0000 (19:53 +0000)
Updates #51400

Change-Id: I61733574362d4cf3cb65122bd13361e5c0f6728c
Reviewed-on: https://go-review.googlesource.com/c/go/+/410375
Run-TryBot: Heschi Kreinick <heschi@google.com>
TryBot-Result: Gopher Robot <gobot@golang.org>
Reviewed-by: Michael Pratt <mpratt@google.com>
Run-TryBot: Michael Pratt <mpratt@google.com>
Reviewed-by: Heschi Kreinick <heschi@google.com>
Auto-Submit: Michael Pratt <mpratt@google.com>

doc/go1.19.html

index 06bd7bcff147726b382a27b843e049098a844a2a..4e6699c289eaf8fa9ea426f219b20682a7b0006b 100644 (file)
@@ -343,7 +343,20 @@ Do not send CLs removing the interior tags from such phrases.
   </dd>
   <dd>
     <p><!-- CL 400654 -->
-      TODO: <a href="https://go.dev/cl/400654">https://go.dev/cl/400654</a>: permit use of Resolver.PreferGo, netgo on Windows and Plan 9
+      <a href="/pkg/net/#Resolver.PreferGo"><code>Resolver.PreferGo</code></a>
+      is now implemented on Windows and Plan 9. It previously only worked on Unix
+      platforms. Combined with
+      <a href="/pkg/net/#Dialer.Resolver"><code>Dialer.Resolver</code></a> and
+      <a href="/pkg/net/#Resolver.Dial"><code>Resolver.Dial</code></a>, it's now
+      possible to write portable programs and be in control of all DNS name lookups
+      when dialing.
+    </p>
+    <p>
+      The <code>net</code> package now has initial support for the <code>netgo</code>
+      build tag on Windows. When used, the package uses the Go DNS client (as used
+      by <code>Resolver.PreferGo</code>) instead of asking Windows for
+      DNS results. The upstream DNS server it discovers from Windows
+      may not yet be correct with complex system network configurations, however.
     </p>
   </dd>
 </dl><!-- net -->