2016-11-15 09:13:46 -07:00
<!-- {
"Title": "Go 1.8 Release Notes",
"Path": "/doc/go1.8",
"Template": true
}-->
<!--
NOTE: In this document and others in this directory, the convention is to
set fixed-width phrases with non-fixed-width spaces, as in
< code > hello< / code > < code > world< / code > .
Do not send CLs removing the interior tags from such phrases.
-->
< style >
ul li { margin: 0.5em 0; }
< / style >
< h2 id = "introduction" > DRAFT RELEASE NOTES - Introduction to Go 1.8< / h2 >
< p > < strong >
Go 1.8 is not yet released. These are work-in-progress
release notes. Go 1.8 is expected to be released in February 2017.
< / strong > < / p >
< p >
The latest Go release, version 1.8, arrives six months after < a href = "go1.7" > Go 1.7< / a > .
Most of its changes are in the implementation of the toolchain, runtime, and libraries.
There is one minor change to the language specification.
As always, the release maintains the Go 1 < a href = "/doc/go1compat.html" > promise of compatibility< / a > .
We expect almost all Go programs to continue to compile and run as before.
< / p >
< p >
The release < a href = "#ports" > adds support for 32-bit MIPS< / a > ,
< a href = "#compiler" > updates the compiler back end< / a > to generate more efficient code,
< a href = "#gc" > reduces GC pauses< / a > by eliminating stop-the-world stack rescanning,
< a href = "#h2push" > adds HTTP/2 Push support< / a > ,
< a href = "#httpshutdown" > adds HTTP graceful shutdown< / a > ,
and < a href = "#sort" > simplifies sorting slices< / a > .
< / p >
< h2 id = "language" > Changes to the language< / h2 >
< p >
2016-11-22 08:24:13 -07:00
When explicitly converting structs, tags are now ignored for structural type identity.
See < a href = "https://golang.org/cl/24190" > change 24190< / a > for details.
< / p >
< p > <!-- CL 17711 -->
The language specification now only requires that implementations
support up to 16-bit exponents in constants. This does not affect
either the < code > gc< / code > or < code > gccgo< / code > compilers, both of
which still support 32-bit exponents.
2016-11-15 09:13:46 -07:00
< / p >
< h2 id = "ports" > Ports< / h2 >
< p >
Go now supports 32-bit MIPS on Linux for both big-endian
(< code > linux/mips< / code > ) and little-endian machines
(< code > linux/mipsle< / code > ).
< / p >
< p >
2016-11-22 08:24:13 -07:00
Go now requires DragonFly BSD 4.4.4 or later. <!-- CL 29491 -->
2016-11-15 09:13:46 -07:00
< / p >
< p >
The Plan 9 port's networking support is now much more complete
and matches the behavior of Unix and Windows with respect to deadlines
and cancelation.
< / p >
2016-11-22 08:24:13 -07:00
< p >
Go 1.8 now only supports OS X 10.8 or later. This is likely the last
Go release to continue supporting 10.8. Compiling Go or running
binaries on older OS X versions is untested.
< / p >
2016-11-15 09:13:46 -07:00
< h3 id = "known_issues" > Known Issues< / h3 >
< p >
2016-11-22 08:24:13 -07:00
There are some instabilities on FreeBSD and NetBSD that are known but not understood.
2016-11-15 09:13:46 -07:00
These can lead to program crashes in rare cases.
See
2016-11-22 08:24:13 -07:00
< a href = "https://golang.org/issue/15658" > issue 15658< / a > ,
< a href = "https://golang.org/issue/16396" > issue 16396< / a > , and
< a href = "https://golang.org/issue/16511" > issue 16511< / a > .
Any help in solving these issues would be appreciated.
2016-11-15 09:13:46 -07:00
< / p >
< h2 id = "tools" > Tools< / h2 >
< h3 id = "cmd_asm" > Assembler< / h3 >
< p >
For 64-bit x86 systems, the following instructions have been added:
< code > VBROADCASTSD< / code > ,
< code > BROADCASTSS< / code > ,
< code > MOVDDUP< / code > ,
< code > MOVSHDUP< / code > ,
< code > MOVSLDUP< / code > ,
< code > VMOVDDUP< / code > ,
< code > VMOVSHDUP< / code > ,
and < code > VMOVSLDUP< / code > .< / p >
< p >
For 64-bit PPC systems, the common vector scalar instructions have been
added. See < a href = "https://golang.org/cl/30510" > change 30510< / a > .
< / p >
< h3 id = "tool_yacc" > Yacc< / h3 >
2016-11-22 08:24:13 -07:00
< p > <!-- CL 27324, CL 27325 -->
2016-11-15 09:13:46 -07:00
The < code > yacc< / code > (previously available via
“< code > go< / code > < code > tool< / code > < code > yacc< / code > ”)
has been removed. As of Go 1.7 it was no longer used by the Go compiler.
2016-11-22 12:30:16 -07:00
It has moved to the “tools” repository and is and is available via
2016-11-15 09:13:46 -07:00
< code > go get < a href = "https://godoc.org/golang.org/x/tools/cmd/goyacc" > golang.org/x/tools/cmd/goyacc< / a > < / code > .
< / p >
< h3 id = "compiler" > Compiler Toolchain< / h3 >
< p >
Go 1.7 introduced a new compiler back end for 64-bit x86 systems.
In Go 1.8, that back end has been developed further and is now used for
all architectures.
< / p >
< p >
The new back end, based on
< a href = "https://en.wikipedia.org/wiki/Static_single_assignment_form" > SSA< / a > ,
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
< a href = "https://golang.org/test/bench/go1/" > our benchmark programs< / a > by N-M%.
TODO: ARM binary size & perf numbers.
< / p >
< p >
The temporary < code > -ssa=0< / code > flag introduced in Go 1.7 to disable
the new backend has been removed in Go 1.8.
< / p >
< p >
2016-11-22 08:24:13 -07:00
In addition to enabling the new compiler back end for all systems,
Go 1.8 also introduces a new compiler front end. The new compiler
front end should not be noticeable to users is the foundation for
future performance work.
< / p >
< p >
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.
2016-11-15 09:13:46 -07:00
< / p >
< p >
2016-11-22 08:24:13 -07:00
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.
2016-11-15 09:13:46 -07:00
< / p >
< h3 id = "cmd_cgo" > Cgo< / h3 >
< p > TODO< / p >
< h3 id = "gccgo" > Gccgo< / h3 >
< p > TODO< / p >
< h3 id = "cmd_go" > Go command< / h3 >
< p >
The < a href = "/cmd/go/" > < code > go< / code > < / a > command's basic operation
is unchanged, but there are a number of changes worth noting.
< / p >
< p >
A new “< code > go< / code > < code > bug< / code > ” command helps users file bug reports.
< / p >
2016-11-22 05:24:07 -07:00
< h3 id = "cmd_doc" > Go doc< / h3 >
2016-11-22 08:24:13 -07:00
< p > <!-- CL 25419 -->
2016-11-22 05:24:07 -07:00
The “< code > go< / code > < code > doc< / code > ” command
now groups constants and variables with their type,
following the behavior of
< a href = "/cmd/godoc/" > < code > godoc< / code > < / a > .
< / p >
2016-11-22 08:24:13 -07:00
< p > <!-- CL 25420 -->
2016-11-22 05:24:07 -07:00
In order to improve the readability of the < code > doc< / code > 's
output, each summary of the first-level items is guaranteed to
occupy a single line.
< / p >
2016-11-15 09:13:46 -07:00
2016-11-22 08:24:13 -07:00
< p > <!-- CL 31852 -->
Documentation for interface methods is now only shown when requested
explicitly.
< / p >
< h3 id = "plugin" > Plug-ins< / h3 >
< p >
Go now supports a “< code > plugin< / code > ” build mode for generating
plug-ins written in Go, and a
new < a href = "/pkg/plugin/" > < code > plugin< / code > < / a > package for
loading such plug-ins at run time. Plug-ins support is only currently
available on Linux and Darwin.
< / p >
< h2 id = "runtime" > Runtime< / h2 >
< h3 id = "liveness" > Argument Liveness< / h3 >
< p >
<!-- Issue 15843 --> The garbage collector no longer considers
arguments live throughout the entirety of a function. For more
information, and for how to force a variable to remain live, see
the < a href = "/pkg/runtime/#KeepAlive" > < code > runtime.KeepAlive< / code > < / a >
function added in Go 1.7.
< / p >
< h3 id = "memstats" > MemStats Documentation< / h3 >
< p > <!-- CL 28972 -->
The runtime's < a href = "/pkg/runtime/#MemStats" > < code > MemStats< / code > < / a >
2016-11-22 12:30:16 -07:00
type has been more thoroughly documented.
2016-11-22 08:24:13 -07:00
< / p >
2016-11-15 09:13:46 -07:00
< h2 id = "performance" > Performance< / h2 >
< p >
As always, the changes are so general and varied that precise statements
about performance are difficult to make.
Most programs should run a bit faster,
due to speedups in the garbage collector and
2016-11-22 08:24:13 -07:00
optimizations in the standard library.
2016-11-15 09:13:46 -07:00
< / p >
< p >
There have been significant optimizations bringing more than 10% improvements
to implementations in the
TODO TODO:
< a href = "/pkg/foo/" > < code > foo< / code > < / a > ,
< a href = "/pkg/bar/" > < code > bar< / code > < / a > ,
and
< a href = "/pkg/quux/" > < code > quux< / code > < / a >
packages.
< / p >
< h3 id = "gc" > Garbage Collector< / h3 >
< p >
Garbage collection pauses should be significantly shorter than they
were in Go 1.7, often as low as 10 microseconds and usually under 100
microseconds.
See the
< a href = "https://github.com/golang/proposal/blob/master/design/17503-eliminate-rescan.md" >
document on eliminating stop-the-world stack re-scanning< / a > for details.
More work remains for Go 1.9.
< / p >
< h3 id = "defer" > Defer< / h3 >
2016-11-22 12:57:49 -07:00
<!-- CL 29656, CL 29656 -->
2016-11-15 09:13:46 -07:00
< p > < code > defer< / code > calls are now about twice as fast.< / p >
< h3 id = "cgoperf" > Cgo< / h3 >
< p > Calls from Go into C are now TODO% faster.< / p >
2016-11-22 08:24:13 -07:00
< h2 id = "library" > Standard library< / h2 >
2016-11-15 09:13:46 -07:00
< h3 id = "examples" > Examples< / h3 >
< p >
2016-11-22 08:24:13 -07:00
Examples have been added to the documentation across many packages.
2016-11-15 09:13:46 -07:00
< / p >
2016-11-22 08:24:13 -07:00
< h3 id = "sortslice" > Sort< / h3 >
2016-11-15 09:13:46 -07:00
< p >
The < a href = "/pkg/sort/" > sort< / a > package
now includes a convenience function
2016-11-22 08:24:13 -07:00
< a href = "/pkg/sort/#Slice" > < code > Slice< / code > < / a > to sort a
2016-11-15 09:13:46 -07:00
slice given a < em > less< / em > function.
In many cases this means that writing a new sorter type is not
necessary.
< / p >
< p >
Also new are
2016-11-22 08:24:13 -07:00
< a href = "/pkg/sort/#SliceStable" > < code > SliceStable< / code > < / a > and
< a href = "/pkg/sort/#SliceIsSorted" > < code > SliceIsSorted< / code > < / a > .
2016-11-15 09:13:46 -07:00
< / p >
< h3 id = "h2push" > HTTP/2 Push< / h3 >
< p >
The < a href = "/pkg/net/http/" > net/http< / a > package now includes a
mechanism to
send HTTP/2 server pushes from a
< a href = "/pkg/net/http/#Handler" > < code > Handler< / code > < / a > .
Similar to the existing < code > Flusher< / code > and < code > Hijacker< / code >
interfaces, an HTTP/2
< a href = "/pkg/net/http/#ResponseWriter" > < code > ResponseWriter< / code > < / a >
now implements the new
< a href = "/pkg/net/http/#Pusher" > < code > Pusher< / code > < / a > interface.
< / p >
2016-11-22 20:46:58 -07:00
< h3 id = "http_shutdown" > HTTP Server Graceful Shutdown< / h3 >
< p > <!-- CL 32329 -->
The HTTP Server now has support for graceful shutdown using the new
< a href = "/pkg/net/http/#Server.Shutdown" > < code > Server.Shutdown< / code > < / a >
method. The related and more abrupt
< a href = "/pkg/net/http/#Server.Close" > < code > Server.Close< / code > < / a >
is also new.
< / p >
2016-11-15 09:13:46 -07:00
< h3 id = "minor_library_changes" > Minor changes to the library< / h3 >
< p >
As always, there are various minor changes and updates to the library,
made with the Go 1 < a href = "/doc/go1compat" > promise of compatibility< / a >
in mind.
< / p >
2016-11-22 05:24:07 -07:00
< dl id = "archive_tar" > < dt > < a href = "/pkg/archive/tar/" > archive/tar< / a > < / dt >
< dd >
2016-11-15 09:13:46 -07:00
2016-11-22 12:57:49 -07:00
< p > <!-- CL 28471, CL 31440, CL 31441, CL 31444, CL 28418, CL 31439 -->
2016-11-22 05:24:07 -07:00
The tar implementation corrects many bugs in corner cases of the file format.
2016-11-22 12:30:16 -07:00
The < a href = "/pkg/archive/tar/#Reader" > < code > Reader< / code > < / a >
is now able to process tar files in the PAX format with entries larger than 8GB.
The < a href = "/pkg/archive/tar/#Writer" > < code > Writer< / code > < / a >
no longer produces invalid tar files in some situations involving long pathnames.
2016-11-22 05:24:07 -07:00
< / p >
< / dd >
< / dl >
2016-11-22 12:57:49 -07:00
< dl id = "archive_zip" > < dt > < a href = "/pkg/archive/zip/" > archive/zip< / a > < / dt >
< dd >
< p > <!-- CL 18274 -->
The zip < code > Reader< / code > now supports modification times in
the NTFS, UNIX, and Extended Time Stamp metadata fields.
<!-- CL 30811 -->
When writing zip files, the Extended Time Stamp field is written
if TODO: validate implementation.
< / p >
< / dd >
< / dl >
2016-11-22 05:24:07 -07:00
< dl id = "compress_flate" > < dt > < a href = "/pkg/compress/flate/" > compress/flate< / a > < / dt >
< dd >
2016-11-22 12:57:49 -07:00
< p > <!-- CL 31640, CL 31174, CL 32149 -->
2016-11-22 05:24:07 -07:00
There have been some minor fixes to the encoder to improve the
compression ratio in certain situations. As a result, the exact
2016-11-22 12:30:16 -07:00
encoded output of < code > DEFLATE< / code > may be different from Go 1.7. Since
DEFLATE is the underlying compression of gzip, png, zlib, and zip,
2016-11-22 05:24:07 -07:00
those formats may have changed outputs.
< / p >
< p >
The encoder, when operating in
< a href = "/pkg/compress/flate/#NoCompression" > < code > NoCompression< / code > < / a >
mode, now produces a consistent output that is not dependent on
the size of the input buffer to the
< a href = "/pkg/compress/flate/#Writer.Write" > < code > Write< / code > < / a >
method.
< / p >
2016-11-22 12:57:49 -07:00
< p > <!-- CL 28216 -->
The decoder, upon encountering an error, now returns any
buffered data it had uncompressed along with the error.
< / p >
2016-11-22 05:24:07 -07:00
< / dd >
< / dl >
< dl id = "compress_gzip" > < dt > < a href = "/pkg/compress/gzip/" > compress/gzip< / a > < / dt >
< dd >
< p >
The < a href = "/pkg/compress/gzip/#Writer" > < code > Writer< / code > < / a >
now encodes a zero < code > MTIME< / code > field when
the < a href = "/pkg/compress/gzip/#Header" > < code > Header.ModTime< / code > < / a >
field is the zero value.
In previous releases of Go, the < code > Writer< / code > would encode
a non-sensible value.
Similarly,
the < a href = "/pkg/compress/gzip/#Reader" > < code > Reader< / code > < / a >
now updates the < code > Header.ModTime< / code > field only if the
2016-11-22 12:30:16 -07:00
encoded < code > MTIME< / code > field is non-zero.
2016-11-22 05:24:07 -07:00
< / p >
< / dd >
< / dl >
2016-11-15 09:13:46 -07:00
2016-11-22 12:30:16 -07:00
< dl id = "context" > < dt > < a href = "/pkg/context/" > context< / a > < / dt >
2016-11-22 08:24:13 -07:00
< dd >
< p > <!-- CL 30370 -->
2016-11-22 12:30:16 -07:00
The < a href = "/pkg/context#DeadlineExceeded" > < code > DeadlineExceeded< / code > < / a >
error now implements
2016-11-22 08:24:13 -07:00
< a href = "/pkg/net/#Error" > < code > net.Error< / code > < / a >
and reports true for both the < code > Timeout< / code > and
< code > Temporary< / code > methods.
< / p >
< / dd >
< / dl >
2016-11-23 16:51:45 -07:00
< dl id = "database_sql" > < dt > < a href = "/pkg/database/sql/" > database/sql< / a > < / dt >
< dd >
< p >
The package now supports < code > context.Context< / code > . There are new methods
ending in < code > Context< / code > such as
< a href = "/pkg/database/sql/#DB.QueryContext" > < code > DB.QueryContext< / code > < / a > and
< a href = "/pkg/database/sql/#DB.PrepareContext" > < code > DB.PrepareContext< / code > < / a >
that support < code > Context< / code > . By using the new < code > Context< / code > methods it ensures
connections are closed and returned to the connection pool when the
request is done. It also enables canceling in-progress queries
should the driver support it. Finally, using the < code > Context< / code >
methods allows the database pool to cancel waiting for the next
available connection.
< / p >
< p >
The < a href = "/pkg/database/sql#IsolationLevel" > < code > IsolationLevel< / code > < / a >
can now be set when starting a transaction by setting the isolation level
on the < code > Context< / code > then passing that < code > Context< / code > to
< a href = "/pkg/database/sql#DB.BeginContext" > < code > DB.BeginContext< / code > < / a > .
An error will be returned if an isolation level is selected that the driver
does not support. A read-only attribute may also be set on the transaction
with < a href = "/pkg/database/sql/#ReadOnlyContext" > < code > ReadOnlyContext< / code > < / a >
< / p >
< p >
Queries now expose the SQL column type information for drivers that support it.
Rows can return < a href = "/pkg/database/sql#Rows.ColumnTypes" > < code > ColumnTypes< / code > < / a >
which can include SQL type information, column type lengths, and the Go type.
< / p >
< p >
Multiple result sets are now supported on Rows. After
< a href = "/pkg/database/sql/#Rows.Next" > < code > Rows.Next< / code > < / a > returns false
< a href = "/pkg/database/sql/#Rows.NextResultSet" > < code > Rows.NextResultSet< / code > < / a >
may be called to advance to the next result set. The existing < code > Rows< / code >
should be continued to be used after it advances to the next result set.
< / p >
< p >
< a href = "/pkg/database/sql/#NamedParam" > < code > NamedParam< / code > < / a > may be used
as query arguments. The new function < a href = "/pkg/database/sql/#Param" > < code > Param< / code > < / a >
helps create a < a href = "/pkg/database/sql/#NamedParam" > < code > NamedParam< / code > < / a >
more succinctly.
< p >
Drivers that support the new < a href = "/pkg/database/sql/driver/#Pinger" > < code > Pinger< / code > < / a >
interface can now check if the server is still alive when the the
< a href = "/pkg/database/sql/#DB.Ping" > < code > DB.Ping< / code > < / a >
or < a href = "/pkg/database/sql/#DB.PingContext" > < code > DB.PingContext< / code > < / a >
is called.
< / p >
< p >
The new < code > Context< / code > query methods work for all drivers, but
< code > Context< / code > cancelation is not responsive unless the driver has been
updated to used them. The other features require driver support in
< a href = "/pkg/database/sql/driver" > < code > database/sql/driver< / code > < / a > .
Driver authors should review the new interfaces. Users of existing
driver should review the driver documentation to see what
it supports and any system specific documentation on each feature.
< / p >
< / dd >
< / dl >
2016-11-22 12:57:49 -07:00
< dl id = "debug_pe" > < dt > < a href = "/pkg/debug/pe/" > debug/pe< / a > < / dt >
< dd >
< p > <!-- CL 22720, CL 27212, CL 22181, CL 22332, CL 22336, Issue 15345 -->
TODO: describe Issue 15345 and CL 22181, CL 22332, CL 22336
< pre > pkg debug/pe, method (*COFFSymbol) FullName(StringTable) (string, error)
pkg debug/pe, method (StringTable) String(uint32) (string, error)
pkg debug/pe, type File struct, COFFSymbols []COFFSymbol
pkg debug/pe, type File struct, StringTable StringTable
pkg debug/pe, type Reloc struct
pkg debug/pe, type Reloc struct, SymbolTableIndex uint32
pkg debug/pe, type Reloc struct, Type uint16
pkg debug/pe, type Reloc struct, VirtualAddress uint32
pkg debug/pe, type Section struct, Relocs []Reloc
pkg debug/pe, type StringTable []uint8< / pre >
< / p >
< / dd >
< / dl >
< dl id = "encoding_base64" > < dt > < a href = "/pkg/encoding/base64/" > encoding/base64< / a > < / dt >
< dd >
< p > <!-- CL 24964 -->
The new < a href = "/pkg/encoding/base64/#Encoding.Strict" > < code > Encoding.Strict< / code > < / a > method returns an < code > Encoding< / code > that causes the decoder to return an error when the trailing padding bits are not zero.
< / p >
< / dd >
< / dl >
< dl id = "encoding_binary" > < dt > < a href = "/pkg/encoding/binary/" > encoding/binary< / a > < / dt >
2016-11-22 08:24:13 -07:00
< dd >
< p > <!-- CL 28514 -->
The package now supports boolean values.
TODO: add docs in encoding/binary package, then link to package docs
here.
< / p >
< / dd >
< / dl >
2016-11-22 12:57:49 -07:00
< dl id = "encoding_json" > < dt > < a href = "/pkg/encoding/json/" > encoding/json< / a > < / dt >
< dd >
< p > <!-- CL 18692 -->
< a href = "/pkg/encoding/json/#UnmarshalTypeError" > < code > UnmarshalTypeError< / code > < / a >
now includes the struct and field name.
< / p >
< p > <!-- CL 31932 -->
A < code > nil< / code > < a href = "/pkg/encoding/json/#Marshaler" > < code > Marshaler< / code > < / a >
now marshals as a JSON "< code > null< / code > " value.
< / p >
< p > <!-- CL 21811 -->
A < a href = "/pkg/encoding/json/#RawMessage" > < code > RawMessage< / code > < / a > value now
marshals the same as its pointer type.
< / p >
< p > <!-- CL 30371 -->
Numbers are now formatted in the same floating point format as they are in ES6.
< / p >
< p > <!-- CL 30944 -->
Implementations
of < a href = "/pkg/encoding/json/#Unmarshaler" > < code > Unmarshaler< / code > < / a >
are now called with the literal "< code > null< / code > " and can
decide what to do with it.
< / p >
< / dd >
< / dl >
< dl id = "encoding_pem" > < dt > < a href = "/pkg/encoding/pem/" > encoding/pem< / a > < / dt >
< dd >
< p > <!-- CL 27391 -->
The PEM decoder is now strict about the format of the ending line.
< / p >
< / dd >
< / dl >
2016-11-22 08:24:13 -07:00
< dl id = "expvar" > < dt > < a href = "/pkg/expvar/" > expvar< / a > < / dt >
< dd >
< p > <!-- CL 30917 -->
The new methods
< a href = "/pkg/expvar/#Int.Value" > < code > Int.Value< / code > < / a > ,
< a href = "/pkg/expvar/#String.Value" > < code > String.Value< / code > < / a > ,
< a href = "/pkg/expvar/#Float.Value" > < code > Float.Value< / code > < / a > , and
< a href = "/pkg/expvar/#Func.Value" > < code > Func.Value< / code > < / a >
report the current value of an exported variable.
< / p >
< p > <!-- CL 24722 -->
The new
function < a href = "/pkg/expvar/#Handler" > < code > Handler< / code > < / a >
returns the package's HTTP handler, to enable installing it in
non-standard locations.
< / p >
< / dd >
< / dl >
2016-11-22 12:57:49 -07:00
2016-11-22 08:24:13 -07:00
< dl id = "image_png" > < dt > < a href = "/pkg/image/png/" > image/png< / a > < / dt >
< dd >
< p > <!-- CL 32143, CL 32140 -->
The PNG decoder now supports truecolor and grayscale transparency.
< / p >
< p > <!-- CL 29872 -->
The PNG encoder is now faster and creates smaller output
when encoding paletted images.
< / p >
< / dd >
< / dl >
< dl id = "math_rand" > < dt > < a href = "/pkg/math/rand/" > math/rand< / a > < / dt >
< dd >
< p >
There is a new
method < a href = "/pkg/math/rand/#Rand.Uint64" > < code > Rand.Uint64< / code > < / a >
to return < code > uint64< / code > values. <!-- CL 27253 -->
< / p >
< / dd >
< / dl >
< dl id = "mime_quotedprintable" > < dt > < a href = "/pkg/mime/quotedprintable/" > mime/quotedprintable< / a > < / dt >
< dd >
< p >
The package's parsing has been relaxed in two ways to accept
more input seen in the wild. First, it now accepts
a < code > =< / code > sign even if it's not followed by two hex
digits. <!-- CL 32174 -->
Second, it accepts a trailing soft line-break at the end of a
message. <!-- CL 27530 --> . That is, the final byte of the
message may be a < code > =< / code > sign and it will now be ignored.
< / p >
< / dd >
< / dl >
< dl id = "net_http" > < dt > < a href = "/pkg/net/http/" > net/http< / a > < / dt >
< dd >
2016-11-22 20:46:58 -07:00
< p > Server changes:< / p >
< ul >
< li > The server now supports graceful shutdown support, < a href = "#http_shutdown" > mentioned above< / a > .< / li >
< li > <!-- CL 32024 -->
The < a href = "/pkg/net/http/#Server" > < code > Server< / code > < / a > now
has new configuration options
< code > ReadHeaderTimeout< / code > and < code > IdleTimeout< / code > .
The previously ill-defined < code > WriteTimeout< / code > is now
documented.
< / li >
< li > <!-- CL 32014 -->
< a href = "/pkg/net/http/#FileServer" > < code > FileServer< / code > < / a >
and
< a href = "/pkg/net/http/#ServeContent" > < code > ServeContent< / code > < / a >
now support HTTP < code > If-Match< / code > conditional requests,
in addition to the previous < code > If-None-Match< / code >
support.
< / li >
< li > <!-- CL 27950 -->
The server now logs bad requests.
< / li >
< / ul >
2016-11-22 08:24:13 -07:00
< p >
2016-11-22 20:46:58 -07:00
There are several additions to what a server's < code > Handler< / code > can do:
2016-11-22 08:24:13 -07:00
< / p >
2016-11-22 20:46:58 -07:00
< ul >
< li > <!-- CL 31173 -->
The < a href = "/pkg/context/#Context" > < code > Context< / code > < / a >
returned
by < a href = "/pkg/net/http/#Request.Context" > < code > Request.Context< / code > < / a >
is canceled if the underlying < code > net.Conn< / code >
closes. For instance, if the user closes their browser in the
middle of a slow request, the < code > Handler< / code > can now
detect that the user is gone. This complements the
existing < a href = "/pkg/net/http/#CloseNotifier" > < code > CloseNotifier< / code > < / a >
support.
< / li >
< li > <!-- CL 32479 --> There is now a second way to serve trailers
for when the trailer name is not known before the headers are
written (via a call to
to < code > ResponseWriter.WriteHeader< / code > ). The old way
continues to work, but when the trailer is only known after the
header has been written, see the
new < a href = "/pkg/net/http/#TrailerPrefix" > < code > TrailerPrefix< / code > < / a > .< / li >
< li > <!-- CL 33099 -->
A < code > Handler< / code > now has a supported mechanism to abort a
response: panicking with
< a href = "/pkg/net/http/#ErrAbortHandler" > < code > ErrAbortHandler< / code > < / a > .
< / li >
< li > <!-- CL 30812 -->
There is now a supported mechanism to test whether a
< code > ResponseWriter< / code > has been hijacked: < code > Write< / code > zero bytes to it.
While this previously returned
< a href = "/pkg/net/http/#ErrHijacked" > < code > ErrHijacked< / code > < / a > , now
it also does so without spamming the server's error log.
< / li >
< / ul >
< p > Client & Transport changes:< / p >
< ul >
< li > <!-- CL 28930 -->
The < code > Client< / code > now copies request headers on redirect.
< / li >
< li > <!-- CL 29072 -->
The < code > Transport< / code > now supports international domain names.
< / li >
< li > <!-- CL 31733, CL 29852 -->
The < code > Client< / code > now supports 307 and 308 redirects.
If the redirect involves re-sending the request body,
the request must have the new
< a href = "/pkg/net/http/#Request" > < code > Request.GetBody< / code > < / a >
field defined.
< a href = "pkg/net/http/#NewRequest" > < code > NewRequest< / code > < / a >
sets < code > Request.GetBody< / code > automatically for common
body types.
< / li >
< li > <!-- CL 32482 -->
The < code > Transport< / code > now rejects requests for URLs with
ports containing non-digit characters.
< / li >
< li > <!-- CL 27117 -->
The < code > Transport< / code > will now retry non-idempotent
requests if no bytes were written before a network failure.
< / li >
< li > <!-- CL 32481 -->
The
new < a href = "/pkg/net/http/#Transport" > < code > Transport.ProxyConnectHeader< / code > < / a >
allows configuration of header values to send to a proxy
during a < code > CONNECT< / code > request.
< / li >
< li > <!-- CL 28077 -->
The < a href = "/pkg/net/http/#DefaultTransport" > < code > DefaultTransport.Dialer< / code > < / a >
now enables < code > DualStack< / code > ("Happy Eyeballs") support,
to use IPv4 as a backup if it looks like IPv6 might be
failing.
< / li >
< / ul >
2016-11-22 08:24:13 -07:00
< / dd >
< / dl >
< dl id = "net_mail" > < dt > < a href = "/pkg/net/mail/" > net/mail< / a > < / dt >
< dd >
< p > <!-- CL 32176 -->
Empty quoted strings are now allowed in the name part of an
address. That is, this is now a legal address:
< code > "" < gopher@example.com> < / code >
< / p >
< p > <!-- CL 31581 -->
The < a href = "/pkg/net/mail/#ParseDate" > < code > ParseDate< / code > < / a >
function has been exported.
< / p >
< / dd >
< / dl >
< dl id = "net_smtp" > < dt > < a href = "/pkg/net/smtp/" > net/smtp< / a > < / dt >
< dd >
< p > <!-- CL 33143 -->
If implementations of the < a href = "/pkg/net/smtp/#Auth" > < code > Auth< / code > < / a >
interface return an empty < code > toServer< / code > value, the package
no longer sends trailing whitespace after the SMTP < code > AUTH< / code >
command, which some servers rejected.
< / p >
< / dd >
< / dl >
< dl id = "net_url" > < dt > < a href = "/pkg/net/url/" > net/url< / a > < / dt >
< dd >
< p > <!-- CL 31322 --> The new functions
< a href = "/pkg/net/url/#PathEscape" > < code > PathEscape< / code > < / a >
and
< a href = "/pkg/net/url/#PathUnescape" > < code > PathUnescape< / code > < / a >
2016-11-22 12:57:49 -07:00
are similar to the query escaping and unescaping functions but
don't treat spaces specially.< / p >
2016-11-22 08:24:13 -07:00
< p > <!-- CL 28933 --> The new methods
< a href = "/pkg/net/url/#URL.Hostname" > < code > URL.Hostname< / code > < / a >
and
< a href = "/pkg/net/url/#URL.Port" > < code > URL.Port< / code > < / a >
are accessors to the hostname and port fields of a URL
and deal with the case where the port may or may not be present.
< / p >
< p > <!-- CL 28343 --> The existing method
< a href = "/pkg/net/url/#URL.ResolveReference" > < code > URL.ResolveReference< / code > < / a >
now properly handles paths with escaped bytes without losing
the escaping.
< / p >
< p > <!-- CL 31467 -->
The < code > URL< / code > type now implements
< a href = "/pkg/encoding/#BinaryMarshaler" > < code > encoding.BinaryMarshaler< / code > < / a > and
< a href = "/pkg/encoding/#BinaryUnmarshaler" > < code > encoding.BinaryUnmarshaler< / code > < / a > .
< / p >
< p > <!-- CL 29610, CL 31582 -->
< code > Parse< / code > now rejects relative URLs containing a "< code > :< / code > " in
the first path segment. Such paths should be prefixed with "< code > ./< / code > ".
The < code > URL.String< / code > method now prepends "< code > ./< / code > " to such paths.
< / p >
< / dd >
< / dl >
2016-11-23 16:51:45 -07:00
< dl id = "os" > < dt > < a href = "/pkg/os/" > os< / a > < / dt >
< dd >
< p >
The new function
< a href = "/pkg/os/#Executable" > < code > Executable< / code > < / a > returns
the running executable path name.
< / p >
< / dd >
< / dl >
2016-11-22 08:24:13 -07:00
< dl id = "reflect" > < dt > < a href = "/pkg/reflect/" > reflect< / a > < / dt >
< dd >
< p > <!-- CL 30088 -->
The new function
< a href = "/pkg/reflect/#Swapper" > < code > Swapper< / code > < / a > was
added to support
the < a href = "#sortslice" > new < code > sort.Slice< / code >
support< / a > .
< / p >
< / dd >
< / dl >
< dl id = "strconv" > < dt > < a href = "/pkg/strconv/" > strconv< / a > < / dt >
< dd >
< p > <!-- CL 31210 -->
The < a href = "/pkg/strconv/#Unquote" > < code > Unquote< / code > < / a >
function now strips carriage returns (< code > \r< / code > ) in
backquoted raw strings.
< / p >
< / dd >
< / dl >
< dl id = "time" > < dt > < a href = "/pkg/time/" > time< / a > < / dt >
< dd >
< p > <!-- CL 20118 --> The new function
< a href = "/pkg/time/#Until" > < code > Until< / code > < / a > complements
the analogous < code > Since< / code > function.
< / p >
< p > <!-- CL 29338 --> < code > ParseDuration< / code > now accepts long fractional parts.< / p >
< p > <!-- CL 33429 -->
< code > Parse< / code > now validates days that are too small, in
addition to days that are too large.
< / p >
2016-11-22 12:57:49 -07:00
< p > <!-- CL 33029 -->
The < code > tzdata< / code > database has been updated to version
2016i for systems that don't already have a local time zone
database.
< / p >
2016-11-22 08:24:13 -07:00
< p >
< / dd >
< / dl >
< dl id = "testing" > < dt > < a href = "/pkg/testing/" > testing< / a > < / dt >
< dd >
< p > <!-- CL 29970 -->
The new method
< a href = "/pkg/testing/#T.Name" > < code > T.Name< / code > < / a >
(and < code > B.Name< / code > ) returns the name of the current
test or benchmark.
< / p >
< p > <!-- CL 31724 -->
The new method
< a href = "/pkg/testing/#T.Context" > < code > T.Context< / code > < / a >
(and < code > B.Context< / code > ) returns
a < a href = "/pkg/context/#Context" > < code > Context< / code > < / a > for
the current running test or benchmark.
< / p >
2016-11-15 09:13:46 -07:00
2016-11-22 08:24:13 -07:00
< p > <!-- CL 32483 -->
The new function
< a href = "/pkg/testing/#CoverMode" > < code > CoverMode< / code > < / a >
reports what the test coverage mode is set to.
< / p >
< p > <!-- CL 32615 -->
Tests and benchmarks are now marked as failed if the race
detector is enabled and a data race occurs during execution.
< / p >
< / dd >
< / dl >
< dl id = "unicode" > < dt > < a href = "/pkg/unicode/" > unicode< / a > < / dt >
< dd >
< p > <!-- CL 30935 -->
< code > SimpleFold< / code > now returns its argument unchanged
if the provided input was an invalid rune.
< / p >
< / dd >
< / dl >
< dl id = "foo" > < dt > < a href = "/pkg/foo/" > foo< / a > < / dt >
< dd >
< p > <!-- CL nnn -->
< / p >
< / dd >
< / dl >
