From 90a8b7361cf0d4f117af49fb9c72ec77c345298b Mon Sep 17 00:00:00 2001
From: Brad Fitzpatrick <bradfitz@golang.org>
Date: Wed, 14 Jun 2017 23:17:30 +0000
Subject: [PATCH] doc: add more Go 1.9 release notes

Only one TODO remains, for pprof changes.

Updates #20587

Change-Id: Ib67b23adc7851cc96455b0c20649c8e565a4f92a
Reviewed-on: https://go-review.googlesource.com/45810
Reviewed-by: Ian Lance Taylor <iant@golang.org>
---
 doc/go1.9.html | 75 ++++++++++++++++++++++++++++++++------------------
 1 file changed, 48 insertions(+), 27 deletions(-)

diff --git a/doc/go1.9.html b/doc/go1.9.html
index 8f33a046d3..2291053898 100644
--- a/doc/go1.9.html
+++ b/doc/go1.9.html
@@ -155,13 +155,6 @@ type T1 = T2
   better generated code, and optimizations in the core library.
 </p>
 
-<p> <!-- CL 39203 -->
-  TODO: There have been significant optimizations bringing more than 10% improvements
-  to implementations in the
-  <a href="/pkg/encoding/gob"><code>encoding/gob</code></a>, and ...
-  packages.
-</p>
-
 <h3 id="gc">Garbage Collector</h3>
 
 <p> <!-- CL 37520 -->
@@ -357,6 +350,19 @@ type T1 = T2
 
 </dl><!-- encoding/base32 -->
 
+<dl id="encoding/csv"><dt><a href="/pkg/encoding/csv/">encoding/csv</a></dt>
+  <dd>
+    <p><!-- CL 41730 -->
+      The new field
+      <a href="/pkg/encoding/csv/#Reader.ReuseRecord"><code>Reader.ReuseRecord</code></a>
+      controls whether calls to
+      <a href="/pkg/encoding/csv/#Reader.Read"><code>Read</code></a>
+      may return a slice sharing the backing array of the previous
+      call's returned slice for improved performance.
+    </p>
+
+</dl><!-- encoding/csv -->
+
 <dl id="fmt"><dt><a href="/pkg/fmt/">fmt</a></dt>
   <dd>
     <p><!-- CL 37051 -->
@@ -459,11 +465,17 @@ type T1 = T2
 <dl id="net"><dt><a href="/pkg/net/">net</a></dt>
   <dd>
     <p><!-- CL 32572 -->
-      TODO: <a href="https://golang.org/cl/32572">https://golang.org/cl/32572</a>: add Resolver.StrictErrors
+      The new
+      <a href="/pkg/net/#Resolver.StrictErrors"><code>Resolver.StrictErrors</code></a>
+      provides control over how Go's built-in DNS resolver handles
+      temporary errors during queries composed of multiple sub-queries,
+      such as an A+AAAA address lookup.
     </p>
 
     <p><!-- CL 37260 -->
-      TODO: <a href="https://golang.org/cl/37260">https://golang.org/cl/37260</a>: allow Resolver to use a custom dialer
+      The new
+      <a href="/pkg/net/#Resolver.Dial"><code>Resolver.Dial</code></a>
+      allows a <code>Resolver</code> to use a custom dial function.
     </p>
 
     <p><!-- CL 40510 -->
@@ -471,10 +483,6 @@ type T1 = T2
       In previous releases it would also wrap addresses in square brackets if they contained a percent ('<code>%</code>') sign.
     </p>
 
-    <p><!-- CL 40512 -->
-      TODO: <a href="https://golang.org/cl/40512">https://golang.org/cl/40512</a>: validate network in Dial{,IP} and Listen{Packet,IP} for IP networks
-    </p>
-
     <p><!-- CL 37913 -->
       The new methods
       <a href="/pkg/net/#TCPConn.SyscallConn"><code>TCPConn.SyscallConn</code></a>,
@@ -485,6 +493,13 @@ type T1 = T2
       provide access to the connections' underlying file descriptors.
     </p>
 
+    <p><!-- 45088 -->
+      It is now safe to call <a href="/pkg/net/#Dial"><code>Dial</code></a> with the address obtained from
+      <code>(*TCPListener).String()</code> after creating the listener with
+      <code><a href="/pkg/net/#Listen">Listen</a>("tcp", ":0")</code>.
+      Previously it failed on some machines with half-configured IPv6 stacks.
+    </p>
+
 </dl><!-- net -->
 
 <dl id="net/http"><dt><a href="/pkg/net/http/">net/http</a></dt>
@@ -550,23 +565,13 @@ type T1 = T2
 
 </dl><!-- net/http/httptest -->
 
-<dl id="net/rpc"><dt><a href="/pkg/net/rpc/">net/rpc</a></dt>
-  <dd>
-    <p><!-- CL 38474 -->
-      TODO: <a href="https://golang.org/cl/38474">https://golang.org/cl/38474</a>: Create empty maps and slices as return type
-    </p>
-
-</dl><!-- net/rpc -->
-
 <dl id="os"><dt><a href="/pkg/os/">os</a></dt>
   <dd>
     <p><!-- CL 37915 -->
-      TODO: <a href="https://golang.org/cl/37915">https://golang.org/cl/37915</a>: parse command line without shell32.dll
-    </p>
-
-    <p><!-- CL 41830 -->
-      TODO: <a href="https://golang.org/cl/41830">https://golang.org/cl/41830</a>: do not report ModeDir for symlinks on windows
-    </p>
+      On Windows,
+      <a href="/pkg/os/#Args"><code>Args</code></a>
+      is now populated without <code>shell32.dll</code>, improving process start-up time by 1-7 ms.
+      </p>
 
 </dl><!-- os -->
 
@@ -648,6 +653,16 @@ type T1 = T2
 
 </dl><!-- runtime/pprof -->
 
+<dl id="runtime/debug"><dt><a href="/pkg/runtime/debug/">runtime/debug</a></dt>
+  <dd>
+    <p><!-- CL 34013 -->
+      Calling
+      <a href="/pkg/runtime/debug/#SetGCPercent"><code>SetGCPercent</code></a>
+      with a negative value no longer runs an immediate garbage collection.
+    </p>
+
+</dl><!-- runtime/debug -->
+
 <dl id="runtime/trace"><dt><a href="/pkg/runtime/trace/">runtime/trace</a></dt>
   <dd>
     <p><!-- CL 36015 -->
@@ -739,5 +754,11 @@ type T1 = T2
       Retrieving the time and sleeping now work correctly under Wine.
     </p>
 
+    <p><!-- CL 44832 -->
+      The included <code>tzdata</code> timezone database has bene
+      updated to version 2017b. As always, it is only used if the
+      system does not already have the database available.
+    </p>
+
 </dl><!-- time -->
 
-- 
2.48.1