From 5d1c60118deb4f7839f56f87ec101401f370192c Mon Sep 17 00:00:00 2001 From: Brad Fitzpatrick Date: Tue, 29 Nov 2016 05:57:18 +0000 Subject: [PATCH] doc: more go1.8.html updates TBR=See https://golang.org/cl/33244 Updates #17929 Change-Id: I648df63aeb67aa2229c7b4fc23676a78b31140a0 Reviewed-on: https://go-review.googlesource.com/33657 Reviewed-by: Brad Fitzpatrick --- doc/go1.8.html | 71 ++++++++++++++++++++++++++++++++++++-------------- 1 file changed, 51 insertions(+), 20 deletions(-) diff --git a/doc/go1.8.html b/doc/go1.8.html index de00f2567e..6f828b13d3 100644 --- a/doc/go1.8.html +++ b/doc/go1.8.html @@ -49,7 +49,8 @@ and simplifies sorting slices.

The language specification now only requires that implementations support up to 16-bit exponents in floating-point constants. This does not affect - either the gc or gccgo compilers, both of + either the “gc” or + gccgo compilers, both of which still support 32-bit exponents.

@@ -214,8 +215,10 @@ generates more compact, more efficient code and provides a better platform for optimizations such as bounds check elimination. The new back end reduces the CPU time required by -our benchmark programs by N-M%. -TODO: ARM binary size & perf numbers. +our benchmark programs by 20-30% +on 32-bit ARM systems. For 64-bit x86 systems, which already used the SSA backend in +Go 1.7, the gains are a more modest 0-10%. Other architectures will likely +see improvements closer to the 32-bit ARM numbers.

@@ -234,15 +237,10 @@ TODO: ARM binary size & perf numbers. The compiler and linker have been optimized and run faster in this release than in Go 1.7, although they are still slower than we would like and will continue to be optimized in future releases. + Compared to the previous release, Go 1.8 is + about 15% faster.

-

- Due to changes across the compiler toolchain and standard library, - binaries built with this release should typically be smaller than - binaries built with Go 1.7, sometimes by as much as TODO numbers. -

- -

Cgo

TODO

@@ -308,6 +306,12 @@ is unchanged, but there are a number of changes worth noting. function added in Go 1.7.

+

+ Updating: Users of finalizers should see the example + in the KeepAlive documentation + to see where a call to KeepAlive might be needed. +

+

MemStats Documentation

@@ -358,7 +362,7 @@ packages.

Cgo

-

Calls from Go into C are now TODO% faster.

+

The overhead of calls from Go into C has been reduced by about half.

Standard library

@@ -644,7 +648,8 @@ pkg debug/pe, type StringTable []uint8
encoding/pem

- The PEM decoder is now strict about the format of the ending line. + Decode + is now strict about the format of the ending line.

@@ -673,10 +678,13 @@ pkg debug/pe, type StringTable []uint8
image/png

- The PNG decoder now supports truecolor and grayscale transparency. + Decode + (and DecodeConfig) + now supports True Color and grayscale transparency.

- The PNG encoder is now faster and creates smaller output + Encoder + is now faster and creates smaller output when encoding paletted images.

@@ -702,19 +710,38 @@ pkg debug/pe, type StringTable []uint8

- The package's parsing has been relaxed in two ways to accept + The + Reader's + parsing has been relaxed in two ways to accept more input seen in the wild. First, it now accepts a = sign even if it's not followed by two hex digits. Second, it accepts a trailing soft line-break at the end of a - message. . That is, the final byte of the + message. That is, the final byte of the message may be a = sign and it will now be ignored.

+
net
+
+ +

+ The Conn documentation + has been updated to clarify expectations of an interface + implementation. Updates in the net/http packages + depend on implementations obeying the documentation. +

+

Updating: implementations of the Conn interface should verify + they implement the documented semantics. TODO: https://golang.org/cl/18097 +

+ +

TODO: many other net changes

+ +
+
net/http
@@ -758,7 +785,9 @@ pkg debug/pe, type StringTable []uint8 middle of a slow request, the Handler can now detect that the user is gone. This complements the existing CloseNotifier - support. + support. This functionality requires that the underlying + net.Conn implements + recently-clarified interface documentation.
  • @@ -794,7 +823,7 @@ pkg debug/pe, type StringTable []uint8 now copies most request headers on redirect. Authentication-specific headers are only sent to the same origin or subdomains thereof. Cookies are not sent again, unless they were set explicitly. - TODO: verify this, and link to docs once https://github.com/golang/go/issues/18096 + TODO: verify this, and link to docs once https://golang.org/issue/18096 is fixed.
    • @@ -973,8 +1002,10 @@ pkg debug/pe, type StringTable []uint8

    - Parse now validates days that are too small, in - addition to days that are too large. + Parse + now rejects dates before the start of a month, such as June 0; + it already rejected dates beyond the end of the month, such as + June 31 and July 32.

    -- 2.50.0