From 012ec29ad46128265e0ec2dd2ac3a620c01619c5 Mon Sep 17 00:00:00 2001
From: Brad Fitzpatrick
Date: Wed, 30 Nov 2016 01:44:15 +0000
Subject: [PATCH] doc: more go1.8.html additions
And start deleting from go1.8.txt.
TBR=See https://golang.org/cl/33244
Updates #17929
Change-Id: I71011d97b23a7ba94cd51e16ae61fda18e8b96eb
Reviewed-on: https://go-review.googlesource.com/33680
Reviewed-by: Brad Fitzpatrick
---
doc/go1.8.html | 130 ++++++++++++++++--
doc/go1.8.txt | 353 +------------------------------------------------
2 files changed, 124 insertions(+), 359 deletions(-)
diff --git a/doc/go1.8.html b/doc/go1.8.html
index 1435542923..88ba6bc0a3 100644
--- a/doc/go1.8.html
+++ b/doc/go1.8.html
@@ -372,13 +372,30 @@ optimizations in the standard library.
-There have been significant optimizations bringing more than 10% improvements
-to implementations in the
-TODO TODO:
-foo,
-bar,
-and
-quux
+There have been optimizations to implementations in the
+bytes,
+crypto/aes,
+crypto/cipher,
+crypto/elliptic,
+crypto/sha256,
+crypto/sha512,
+encoding/asn1,
+encoding/csv,
+encoding/hex,
+encoding/json,
+hash/crc32,
+image/color,
+image/draw,
+math,
+math/big,
+reflect,
+regexp,
+runtime,
+strconv,
+strings,
+syscall,
+text/template, and
+unicode/utf8,
packages.
@@ -483,7 +500,8 @@ now implements the new
As always, there are various minor changes and updates to the library,
made with the Go 1 promise of compatibility
-in mind.
+in mind. The follow sections list the user visible changes and additions.
+Optimizations and bug fixes are not listed.
- archive/tar
@@ -840,6 +858,16 @@ pkg debug/pe, type StringTable []uint8
+- encoding/xml
+ -
+
+ Unmarshal
+ now has wildcard support for collecting all attributes using
+ the new ",any,attr" struct tag.
+
+
+
+
- expvar
-
@@ -860,6 +888,14 @@ pkg debug/pe, type StringTable []uint8
+- go/doc
+ -
+
+ The new IsPredeclared
+ function reports whether a string is a predeclared identifier.
+
+
+
- image/png
-
@@ -974,7 +1010,29 @@ pkg debug/pe, type StringTable []uint8
the listener is closed.
-
TODO: many other net changes
+
+ The new Buffers types permits
+ more efficiently writing to the network from multiple discontiguous buffers
+ in memory. On certain machines, for certain types of connections,
+ this is optimized into an OS-specific batch write operation (such as writev).
+
+
+
+ The new Resolver looks up names and numbers
+ and supports context.Context.
+ The Dialer now has an optional
+ Resolver field.
+
+
+
+ Interfaces is now supported on Solaris.
+
+
+
+ The Go DNS resolver now supports resolv.conf's "rotate"
+ and "option ndots:0" options. The "ndots" option is
+ now respected in the same way as libresolve.
+
@@ -1108,6 +1166,30 @@ pkg debug/pe, type StringTable []uint8
+- net/http/httptrace
+ -
+
+ There is now support for tracing a client request's TLS handshakes with
+ the new
+ ClientTrace.TLSHandshakeStart
+ and
+ ClientTrace.TLSHandshakeDone.
+
+
+
+
+- net/http/httputil
+ -
+
+ The ReverseProxy
+ has a new optional hook,
+ ModifyResponse,
+ for modifying the response from the backend before proxying it to the client.
+
+
+
+
+
- net/mail
-
@@ -1202,6 +1284,22 @@ pkg debug/pe, type StringTable []uint8
+- path/filepath
+ -
+
+
A number of bugs and corner cases on Windows were fixed:
+ Abs now calls Clean paths as documented,
+ Glob now matches
+ "\\?\c:\*",
+ EvalSymlinks now
+ correctly handles "C:.", and
+ Clean now properlys handles a leading ".."
+ in the path.
+
+
+
+
+
- reflect
-
@@ -1224,6 +1322,20 @@ pkg debug/pe, type StringTable []uint8
+- text/template
+ -
+
+ Template.Execute
+ can now take a
+ reflect.Value as its data
+ argument, and
+ FuncMap
+ functions can also accept and return reflect.Value.
+
+
+
+
+
- time
-
diff --git a/doc/go1.8.txt b/doc/go1.8.txt
index 6780b60242..7c61a4f91a 100644
--- a/doc/go1.8.txt
+++ b/doc/go1.8.txt
@@ -1,8 +1,5 @@
-Note: once things are added to go1.8.html or deemed too minor they're
-moved from the sections at top down to the "HTMLified" or "Probably
-omit" sections below.
-
-These top sections remain to be HTMLified or deemed too boring:
+This file lists things yet to be moved into go1.8.html or deemed too
+minor to mention. Either way, delete from here when done.
Tools:
@@ -58,6 +55,7 @@ cmd/pprof: instruction-level granularity in callgrind output (CL 23781)
cmd/trace: add option to output pprof files (CL 23324)
cmd/trace: fix a runnable goroutine count bug (CL 25552)
cmd/trace: move process-wide GC events to their own row (CL 30017)
+internal/trace: fix analysis of EvGoWaiting/EvGoInSyscall events (CL 25572)
cmd/vet: accept space-separated tag lists for compatibility with cmd/go (CL 32030)
cmd/vet: allow ^& uintptr arithmetic (CL 27156)
@@ -70,11 +68,6 @@ cmd/vet: improve asmdecl parameter handling (CL 27150)
cmd/vet: properly handle indexed arguments in printf (CL 24391)
cmd/vet: skip printf check for non-constant format string during failed import (CL 29014)
-crypto/cipher: enforce message size limits for GCM (CL 28410)
-
-encoding/asn1: return error for unexported fields in Marshal, Unmarshal (CL 31540)
-
-encoding/xml: add wildcard support for collecting all attributes (CL 30946)
encoding/xml: prevent omitempty from omitting non-nil pointers to empty values (CL 15684)
fmt: document and adjust Scanf space handling to eliminate a few paradoxes (CL 30611)
@@ -83,42 +76,12 @@ go/build: allow % in ${SRCDIR} expansion for Jenkins (CL 31611)
go/build: do not record go:binary-only-package if build tags not satisfied (CL 31577)
go/build: implement default GOPATH (CL 32019)
-go/doc: add IsPredeclared function (CL 29870)
-go/doc: allow ToHTML to properly handle URLs containing semicolons (CL 25385)
-
go/printer: don't drop required semi/linebreak after /*-comment (CL 33016)
-go/token: fix race in FileSet.PositionFor. (CL 25345)
go/types: expose Default function, which converts untyped T to T (CL 30715)
go/types: match cmd/compile's alignment for complex64 (CL 31939)
html/template: check "type" attribute in