12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448 |
- <!--{
- "Title": "Go 1.10 Release Notes",
- "Path": "/doc/go1.10",
- "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>
- main ul li { margin: 0.5em 0; }
- </style>
- <h2 id="introduction">Introduction to Go 1.10</h2>
- <p>
- The latest Go release, version 1.10, arrives six months after <a href="go1.9">Go 1.9</a>.
- Most of its changes are in the implementation of the toolchain, runtime, and libraries.
- 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>
- This release improves <a href="#build">caching of built packages</a>,
- adds <a href="#test">caching of successful test results</a>,
- runs <a href="#test-vet">vet automatically during tests</a>,
- and
- permits <a href="#cgo">passing string values directly between Go and C using cgo</a>.
- A new <a href="#cgo">compiler option whitelist</a> may cause
- unexpected <a href="https://golang.org/s/invalidflag"><code>invalid
- flag</code></a> errors in code that built successfully with older
- releases.
- </p>
- <h2 id="language">Changes to the language</h2>
- <p>
- There are no significant changes to the language specification.
- </p>
- <p><!-- CL 60230 -->
- A corner case involving shifts of untyped constants has been clarified,
- and as a result the compilers have been updated to allow the index expression
- <code>x[1.0</code> <code><<</code> <code>s]</code> where <code>s</code> is an unsigned integer;
- the <a href="/pkg/go/types/">go/types</a> package already did.
- </p>
- <p><!-- CL 73233 -->
- The grammar for method expressions has been updated to relax the
- syntax to allow any type expression as a receiver;
- this matches what the compilers were already implementing.
- For example, <code>struct{io.Reader}.Read</code> is a valid, if unusual,
- method expression that the compilers already accepted and is
- now permitted by the language grammar.
- </p>
- <h2 id="ports">Ports</h2>
- <p>
- There are no new supported operating systems or processor architectures in this release.
- Most of the work has focused on strengthening the support for existing ports,
- in particular <a href="#asm">new instructions in the assembler</a>
- and improvements to the code generated by the compilers.
- </p>
- <p id="freebsd">
- As <a href="go1.9#freebsd">announced in the Go 1.9 release notes</a>,
- Go 1.10 now requires FreeBSD 10.3 or later;
- support for FreeBSD 9.3 has been removed.
- </p>
- <p id="netbsd">
- Go now runs on NetBSD again but requires the unreleased NetBSD 8.
- Only <code>GOARCH</code> <code>amd64</code> and <code>386</code> have
- been fixed. The <code>arm</code> port is still broken.
- </p>
- <p id="mips">
- On 32-bit MIPS systems, the new environment variable settings
- <code>GOMIPS=hardfloat</code> (the default) and
- <code>GOMIPS=softfloat</code> select whether to use
- hardware instructions or software emulation for floating-point computations.
- </p>
- <p id="openbsd">
- Go 1.10 is the last release that will run on OpenBSD 6.0.
- Go 1.11 will require OpenBSD 6.2.
- </p>
- <p id="darwin">
- Go 1.10 is the last release that will run on OS X 10.8 Mountain Lion or OS X 10.9 Mavericks.
- Go 1.11 will require OS X 10.10 Yosemite or later.
- </p>
- <p id="windows">
- Go 1.10 is the last release that will run on Windows XP or Windows Vista.
- Go 1.11 will require Windows 7 or later.
- </p>
- <h2 id="tools">Tools</h2>
- <h3 id="goroot">Default GOROOT & GOTMPDIR</h3>
- <p>
- If the environment variable <code>$GOROOT</code> is unset,
- the go tool previously used the default <code>GOROOT</code>
- set during toolchain compilation.
- Now, before falling back to that default, the go tool attempts to
- deduce <code>GOROOT</code> from its own executable path.
- This allows binary distributions to be unpacked anywhere in the
- file system and then be used without setting <code>GOROOT</code>
- explicitly.
- </p>
- <p>
- By default, the go tool creates its temporary files and directories
- in the system temporary directory (for example, <code>$TMPDIR</code> on Unix).
- If the new environment variable <code>$GOTMPDIR</code> is set,
- the go tool will creates its temporary files and directories in that directory instead.
- </p>
- <h3 id="build">Build & Install</h3>
- <p>
- The <code>go</code> <code>build</code> command now detects out-of-date packages
- purely based on the content of source files, specified build flags, and metadata stored in the compiled packages.
- Modification times are no longer consulted or relevant.
- The old advice to add <code>-a</code> to force a rebuild in cases where
- the modification times were misleading for one reason or another
- (for example, changes in build flags) is no longer necessary:
- builds now always detect when packages must be rebuilt.
- (If you observe otherwise, please file a bug.)
- </p>
- <p>
- The <code>go</code> <code>build</code> <code>-asmflags</code>, <code>-gcflags</code>, <code>-gccgoflags</code>, and <code>-ldflags</code> options
- now apply by default only to the packages listed directly on the command line.
- For example, <code>go</code> <code>build</code> <code>-gcflags=-m</code> <code>mypkg</code>
- passes the compiler the <code>-m</code> flag when building <code>mypkg</code>
- but not its dependencies.
- The new, more general form <code>-asmflags=pattern=flags</code> (and similarly for the others)
- applies the <code>flags</code> only to the packages matching the pattern.
- For example: <code>go</code> <code>install</code> <code>-ldflags=cmd/gofmt=-X=main.version=1.2.3</code> <code>cmd/...</code>
- installs all the commands matching <code>cmd/...</code> but only applies the <code>-X</code> option
- to the linker flags for <code>cmd/gofmt</code>.
- For more details, see <a href="/cmd/go/#hdr-Compile_packages_and_dependencies"><code>go</code> <code>help</code> <code>build</code></a>.
- </p>
- <p>
- The <code>go</code> <code>build</code> command now maintains a cache of
- recently built packages, separate from the installed packages in <code>$GOROOT/pkg</code> or <code>$GOPATH/pkg</code>.
- The effect of the cache should be to speed builds that do not explicitly install packages
- or when switching between different copies of source code (for example, when changing
- back and forth between different branches in a version control system).
- The old advice to add the <code>-i</code> flag for speed, as in <code>go</code> <code>build</code> <code>-i</code>
- or <code>go</code> <code>test</code> <code>-i</code>,
- is no longer necessary: builds run just as fast without <code>-i</code>.
- For more details, see <a href="/cmd/go/#hdr-Build_and_test_caching"><code>go</code> <code>help</code> <code>cache</code></a>.
- </p>
- <p>
- The <code>go</code> <code>install</code> command now installs only the
- packages and commands listed directly on the command line.
- For example, <code>go</code> <code>install</code> <code>cmd/gofmt</code>
- installs the gofmt program but not any of the packages on which it depends.
- The new build cache makes future commands still run as quickly as if the
- dependencies had been installed.
- To force the installation of dependencies, use the new
- <code>go</code> <code>install</code> <code>-i</code> flag.
- Installing dependency packages should not be necessary in general,
- and the very concept of installed packages may disappear in a future release.
- </p>
- <p>
- Many details of the <code>go</code> <code>build</code> implementation have changed to support these improvements.
- One new requirement implied by these changes is that
- binary-only packages must now declare accurate import blocks in their
- stub source code, so that those imports can be made available when
- linking a program using the binary-only package.
- For more details, see <a href="/cmd/go/#hdr-File_types"><code>go</code> <code>help</code> <code>filetype</code></a>.
- </p>
- <h3 id="test">Test</h3>
- <p>
- The <code>go</code> <code>test</code> command now caches test results:
- if the test executable and command line match a previous run
- and the files and environment variables consulted by that run
- have not changed either, <code>go</code> <code>test</code> will print
- the previous test output, replacing the elapsed time with the string “(cached).”
- Test caching applies only to successful test results;
- only to <code>go</code> <code>test</code>
- commands with an explicit list of packages; and
- only to command lines using a subset of the
- <code>-cpu</code>, <code>-list</code>, <code>-parallel</code>,
- <code>-run</code>, <code>-short</code>, and <code>-v</code> test flags.
- The idiomatic way to bypass test caching is to use <code>-count=1</code>.
- </p>
- <p id="test-vet">
- The <code>go</code> <code>test</code> command now automatically runs
- <code>go</code> <code>vet</code> on the package being tested,
- to identify significant problems before running the test.
- Any such problems are treated like build errors and prevent execution of the test.
- Only a high-confidence subset of the available <code>go</code> <code>vet</code>
- checks are enabled for this automatic check.
- To disable the running of <code>go</code> <code>vet</code>, use
- <code>go</code> <code>test</code> <code>-vet=off</code>.
- </p>
- <p>
- The <code>go</code> <code>test</code> <code>-coverpkg</code> flag now
- interprets its argument as a comma-separated list of patterns to match against
- the dependencies of each test, not as a list of packages to load anew.
- For example, <code>go</code> <code>test</code> <code>-coverpkg=all</code>
- is now a meaningful way to run a test with coverage enabled for the test package
- and all its dependencies.
- Also, the <code>go</code> <code>test</code> <code>-coverprofile</code> option is now
- supported when running multiple tests.
- </p>
- <p>
- In case of failure due to timeout, tests are now more likely to write their profiles before exiting.
- </p>
- <p>
- The <code>go</code> <code>test</code> command now always
- merges the standard output and standard error from a given test binary execution
- and writes both to <code>go</code> <code>test</code>'s standard output.
- In past releases, <code>go</code> <code>test</code> only applied this
- merging most of the time.
- </p>
- <p>
- The <code>go</code> <code>test</code> <code>-v</code> output
- now includes <code>PAUSE</code> and <code>CONT</code> status update
- lines to mark when <a href="/pkg/testing/#T.Parallel">parallel tests</a> pause and continue.
- </p>
- <p>
- The new <code>go</code> <code>test</code> <code>-failfast</code> flag
- disables running additional tests after any test fails.
- Note that tests running in parallel with the failing test are allowed to complete.
- </p>
- <p>
- Finally, the new <code>go</code> <code>test</code> <code>-json</code> flag
- filters test output through the new command
- <code>go</code> <code>tool</code> <code>test2json</code>
- to produce a machine-readable JSON-formatted description of test execution.
- This allows the creation of rich presentations of test execution
- in IDEs and other tools.
- </p>
- <p>
- For more details about all these changes,
- see <a href="/cmd/go/#hdr-Test_packages"><code>go</code> <code>help</code> <code>test</code></a>
- and the <a href="/cmd/test2json/">test2json documentation</a>.
- </p>
- <h3 id="cgo">Cgo</h3>
- <p>
- Options specified by cgo using <code>#cgo CFLAGS</code> and the like
- are now checked against a whitelist of permitted options.
- This closes a security hole in which a downloaded package uses
- compiler options like
- <span style="white-space: nowrap"><code>-fplugin</code></span>
- to run arbitrary code on the machine where it is being built.
- This can cause a build error such as <code>invalid flag in #cgo CFLAGS</code>.
- For more background, and how to handle this error, see
- <a href="https://golang.org/s/invalidflag">https://golang.org/s/invalidflag</a>.
- </p>
- <p>
- Cgo now implements a C typedef like “<code>typedef</code> <code>X</code> <code>Y</code>” using a Go type alias,
- so that Go code may use the types <code>C.X</code> and <code>C.Y</code> interchangeably.
- It also now supports the use of niladic function-like macros.
- Also, the documentation has been updated to clarify that
- Go structs and Go arrays are not supported in the type signatures of cgo-exported functions.
- </p>
- <p>
- Cgo now supports direct access to Go string values from C.
- Functions in the C preamble may use the type <code>_GoString_</code>
- to accept a Go string as an argument.
- C code may call <code>_GoStringLen</code> and <code>_GoStringPtr</code>
- for direct access to the contents of the string.
- A value of type <code>_GoString_</code>
- may be passed in a call to an exported Go function that takes an argument of Go type <code>string</code>.
- </p>
- <p>
- During toolchain bootstrap, the environment variables <code>CC</code> and <code>CC_FOR_TARGET</code> specify
- the default C compiler that the resulting toolchain will use for host and target builds, respectively.
- However, if the toolchain will be used with multiple targets, it may be necessary to specify a different C compiler for each
- (for example, a different compiler for <code>darwin/arm64</code> versus <code>linux/ppc64le</code>).
- The new set of environment variables <code>CC_FOR_<i>goos</i>_<i>goarch</i></code>
- allows specifying a different default C compiler for each target.
- Note that these variables only apply during toolchain bootstrap,
- to set the defaults used by the resulting toolchain.
- Later <code>go</code> <code>build</code> commands use the <code>CC</code> environment
- variable or else the built-in default.
- </p>
- <p>
- Cgo now translates some C types that would normally map to a pointer
- type in Go, to a <code>uintptr</code> instead. These types include
- the <code>CFTypeRef</code> hierarchy in Darwin's CoreFoundation
- framework and the <code>jobject</code> hierarchy in Java's JNI
- interface.
- </p>
- <p>
- These types must be <code>uintptr</code> on the Go side because they
- would otherwise confuse the Go garbage collector; they are sometimes
- not really pointers but data structures encoded in a pointer-sized integer.
- Pointers to Go memory must not be stored in these <code>uintptr</code> values.
- </p>
- <p>
- Because of this change, values of the affected types need to be
- zero-initialized with the constant <code>0</code> instead of the
- constant <code>nil</code>. Go 1.10 provides <code>gofix</code>
- modules to help with that rewrite:
- </p>
- <pre>
- go tool fix -r cftype <pkg>
- go tool fix -r jni <pkg>
- </pre>
- <p>
- For more details, see the <a href="/cmd/cgo/">cgo documentation</a>.
- </p>
- <h3 id="doc">Doc</h3>
- <p>
- The <code>go</code> <code>doc</code> tool now adds functions returning slices of <code>T</code> or <code>*T</code>
- to the display of type <code>T</code>, similar to the existing behavior for functions returning single <code>T</code> or <code>*T</code> results.
- For example:
- </p>
- <pre>
- $ go doc mail.Address
- package mail // import "net/mail"
- type Address struct {
- Name string
- Address string
- }
- Address represents a single mail address.
- func ParseAddress(address string) (*Address, error)
- func ParseAddressList(list string) ([]*Address, error)
- func (a *Address) String() string
- $
- </pre>
- <p>
- Previously, <code>ParseAddressList</code> was only shown in the package overview (<code>go</code> <code>doc</code> <code>mail</code>).
- </p>
- <h3 id="fix">Fix</h3>
- <p>
- The <code>go</code> <code>fix</code> tool now replaces imports of <code>"golang.org/x/net/context"</code>
- with <code>"context"</code>.
- (Forwarding aliases in the former make it completely equivalent to the latter when using Go 1.9 or later.)
- </p>
- <h3 id="get">Get</h3>
- <p>
- The <code>go</code> <code>get</code> command now supports Fossil source code repositories.
- </p>
- <h3 id="pprof">Pprof</h3>
- <p>
- The blocking and mutex profiles produced by the <code>runtime/pprof</code> package
- now include symbol information, so they can be viewed
- in <code>go</code> <code>tool</code> <code>pprof</code>
- without the binary that produced the profile.
- (All other profile types were changed to include symbol information in Go 1.9.)
- </p>
- <p>
- The <a href="/cmd/pprof/"><code>go</code> <code>tool</code> <code>pprof</code></a>
- profile visualizer has been updated to git version 9e20b5b (2017-11-08)
- from <a href="https://github.com/google/pprof">github.com/google/pprof</a>,
- which includes an updated web interface.
- </p>
- <h3 id="vet">Vet</h3>
- <p>
- The <a href="/cmd/vet/"><code>go</code> <code>vet</code></a> command now always has access to
- complete, up-to-date type information when checking packages, even for packages using cgo or vendored imports.
- The reports should be more accurate as a result.
- Note that only <code>go</code> <code>vet</code> has access to this information;
- the more low-level <code>go</code> <code>tool</code> <code>vet</code> does not
- and should be avoided except when working on <code>vet</code> itself.
- (As of Go 1.9, <code>go</code> <code>vet</code> provides access to all the same flags as
- <code>go</code> <code>tool</code> <code>vet</code>.)
- </p>
- <h3 id="diag">Diagnostics</h3>
- <p>
- This release includes a new <a href="/doc/diagnostics.html">overview of available Go program diagnostic tools</a>.
- </p>
- <h3 id="gofmt">Gofmt</h3>
- <p>
- Two minor details of the default formatting of Go source code have changed.
- First, certain complex three-index slice expressions previously formatted like
- <code>x[i+1</code> <code>:</code> <code>j:k]</code> and now
- format with more consistent spacing: <code>x[i+1</code> <code>:</code> <code>j</code> <code>:</code> <code>k]</code>.
- Second, single-method interface literals written on a single line,
- which are sometimes used in type assertions,
- are no longer split onto multiple lines.
- </p>
- <p>
- Note that these kinds of minor updates to gofmt are expected from time to time.
- In general, we recommend against building systems that check that source code
- matches the output of a specific version of gofmt.
- For example, a continuous integration test that fails if any code already checked into
- a repository is not “properly formatted” is inherently fragile and not recommended.
- </p>
- <p>
- If multiple programs must agree about which version of gofmt is used to format a source file,
- we recommend that they do this by arranging to invoke the same gofmt binary.
- For example, in the Go open source repository, our Git pre-commit hook is written in Go
- and could import <code>go/format</code> directly, but instead it invokes the <code>gofmt</code>
- binary found in the current path, so that the pre-commit hook need not be recompiled
- each time <code>gofmt</code> changes.
- </p>
- <h3 id="compiler">Compiler Toolchain</h3>
- <p>
- The compiler includes many improvements to the performance of generated code,
- spread fairly evenly across the supported architectures.
- </p>
- <p>
- The DWARF debug information recorded in binaries has been improved in a few ways:
- constant values are now recorded;
- line number information is more accurate, making source-level stepping through a program work better;
- and each package is now presented as its own DWARF compilation unit.
- </p>
- <p>
- The various <a href="https://docs.google.com/document/d/1nr-TQHw_er6GOQRsF6T43GGhFDelrAP0NqSS_00RgZQ/edit">build modes</a>
- have been ported to more systems.
- Specifically, <code>c-shared</code> now works on <code>linux/ppc64le</code>, <code>windows/386</code>, and <code>windows/amd64</code>;
- <code>pie</code> now works on <code>darwin/amd64</code> and also forces the use of external linking on all systems;
- and <code>plugin</code> now works on <code>linux/ppc64le</code> and <code>darwin/amd64</code>.
- </p>
- <p>
- The <code>linux/ppc64le</code> port now requires the use of external linking
- with any programs that use cgo, even uses by the standard library.
- </p>
- <h3 id="asm">Assembler</h3>
- <p>
- For the ARM 32-bit port, the assembler now supports the instructions
- <code><small>BFC</small></code>,
- <code><small>BFI</small></code>,
- <code><small>BFX</small></code>,
- <code><small>BFXU</small></code>,
- <code><small>FMULAD</small></code>,
- <code><small>FMULAF</small></code>,
- <code><small>FMULSD</small></code>,
- <code><small>FMULSF</small></code>,
- <code><small>FNMULAD</small></code>,
- <code><small>FNMULAF</small></code>,
- <code><small>FNMULSD</small></code>,
- <code><small>FNMULSF</small></code>,
- <code><small>MULAD</small></code>,
- <code><small>MULAF</small></code>,
- <code><small>MULSD</small></code>,
- <code><small>MULSF</small></code>,
- <code><small>NMULAD</small></code>,
- <code><small>NMULAF</small></code>,
- <code><small>NMULD</small></code>,
- <code><small>NMULF</small></code>,
- <code><small>NMULSD</small></code>,
- <code><small>NMULSF</small></code>,
- <code><small>XTAB</small></code>,
- <code><small>XTABU</small></code>,
- <code><small>XTAH</small></code>,
- and
- <code><small>XTAHU</small></code>.
- </p>
- <p>
- For the ARM 64-bit port, the assembler now supports the
- <code><small>VADD</small></code>,
- <code><small>VADDP</small></code>,
- <code><small>VADDV</small></code>,
- <code><small>VAND</small></code>,
- <code><small>VCMEQ</small></code>,
- <code><small>VDUP</small></code>,
- <code><small>VEOR</small></code>,
- <code><small>VLD1</small></code>,
- <code><small>VMOV</small></code>,
- <code><small>VMOVI</small></code>,
- <code><small>VMOVS</small></code>,
- <code><small>VORR</small></code>,
- <code><small>VREV32</small></code>,
- and
- <code><small>VST1</small></code>
- instructions.
- </p>
- <p>
- For the PowerPC 64-bit port, the assembler now supports the POWER9 instructions
- <code><small>ADDEX</small></code>,
- <code><small>CMPEQB</small></code>,
- <code><small>COPY</small></code>,
- <code><small>DARN</small></code>,
- <code><small>LDMX</small></code>,
- <code><small>MADDHD</small></code>,
- <code><small>MADDHDU</small></code>,
- <code><small>MADDLD</small></code>,
- <code><small>MFVSRLD</small></code>,
- <code><small>MTVSRDD</small></code>,
- <code><small>MTVSRWS</small></code>,
- <code><small>PASTECC</small></code>,
- <code><small>VCMPNEZB</small></code>,
- <code><small>VCMPNEZBCC</small></code>,
- and
- <code><small>VMSUMUDM</small></code>.
- </p>
- <p>
- For the S390X port, the assembler now supports the
- <code><small>TMHH</small></code>,
- <code><small>TMHL</small></code>,
- <code><small>TMLH</small></code>,
- and
- <code><small>TMLL</small></code>
- instructions.
- </p>
- <p>
- For the X86 64-bit port, the assembler now supports 359 new instructions,
- including the full AVX, AVX2, BMI, BMI2, F16C, FMA3, SSE2, SSE3, SSSE3, SSE4.1, and SSE4.2 extension sets.
- The assembler also no longer implements <code><small>MOVL</small></code> <code><small>$0,</small></code> <code><small>AX</small></code>
- as an <code><small>XORL</small></code> instruction,
- to avoid clearing the condition flags unexpectedly.
- </p>
- <h3 id="gccgo">Gccgo</h3>
- <p>
- Due to the alignment of Go's semiannual release schedule with GCC's
- annual release schedule,
- GCC release 7 contains the Go 1.8.3 version of gccgo.
- We expect that the next release, GCC 8, will contain the Go 1.10
- version of gccgo.
- </p>
- <h2 id="runtime">Runtime</h2>
- <p>
- The behavior of nested calls to
- <a href="/pkg/runtime/#LockOSThread"><code>LockOSThread</code></a> and
- <a href="/pkg/runtime/#UnlockOSThread"><code>UnlockOSThread</code></a>
- has changed.
- These functions control whether a goroutine is locked to a specific operating system thread,
- so that the goroutine only runs on that thread, and the thread only runs that goroutine.
- Previously, calling <code>LockOSThread</code> more than once in a row
- was equivalent to calling it once, and a single <code>UnlockOSThread</code>
- always unlocked the thread.
- Now, the calls nest: if <code>LockOSThread</code> is called multiple times,
- <code>UnlockOSThread</code> must be called the same number of times
- in order to unlock the thread.
- Existing code that was careful not to nest these calls will remain correct.
- Existing code that incorrectly assumed the calls nested will become correct.
- Most uses of these functions in public Go source code falls into the second category.
- </p>
- <p>
- Because one common use of <code>LockOSThread</code> and <code>UnlockOSThread</code>
- is to allow Go code to reliably modify thread-local state (for example, Linux or Plan 9 name spaces),
- the runtime now treats locked threads as unsuitable for reuse or for creating new threads.
- </p>
- <p>
- Stack traces no longer include implicit wrapper functions (previously marked <code><autogenerated></code>),
- unless a fault or panic happens in the wrapper itself.
- As a result, skip counts passed to functions like <a href="/pkg/runtime/#Caller"><code>Caller</code></a>
- should now always match the structure of the code as written, rather than depending on
- optimization decisions and implementation details.
- </p>
- <p>
- The garbage collector has been modified to reduce its impact on allocation latency.
- It now uses a smaller fraction of the overall CPU when running, but it may run more of the time.
- The total CPU consumed by the garbage collector has not changed significantly.
- </p>
- <p>
- The <a href="/pkg/runtime/#GOROOT"><code>GOROOT</code></a> function
- now defaults (when the <code>$GOROOT</code> environment variable is not set)
- to the <code>GOROOT</code> or <code>GOROOT_FINAL</code> in effect
- at the time the calling program was compiled.
- Previously it used the <code>GOROOT</code> or <code>GOROOT_FINAL</code> in effect
- at the time the toolchain that compiled the calling program was compiled.
- </p>
- <p>
- There is no longer a limit on the <a href="/pkg/runtime/#GOMAXPROCS"><code>GOMAXPROCS</code></a> setting.
- (In Go 1.9 the limit was 1024.)
- </p>
- <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,
- better generated code, and optimizations in the core library.
- </p>
- <h2 id="gc">Garbage Collector</h2>
- <p>
- Many applications should experience significantly lower allocation latency and overall performance overhead when the garbage collector is active.
- </p>
- <h2 id="library">Core library</h2>
- <p>
- All of the changes to the standard library are minor.
- The changes in <a href="#bytes">bytes</a>
- and <a href="#net/url">net/url</a> are the most likely to require updating of existing programs.
- </p>
- <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>
- <dl id="archive/tar"><dt><a href="/pkg/archive/tar/">archive/tar</a></dt>
- <dd>
- <p>
- In general, the handling of special header formats is significantly improved and expanded.
- </p>
- <p>
- <a href="/pkg/archive/tar/#FileInfoHeader"><code>FileInfoHeader</code></a> has always
- recorded the Unix UID and GID numbers from its <a href="/pkg/os/#FileInfo"><code>os.FileInfo</code></a> argument
- (specifically, from the system-dependent information returned by the <code>FileInfo</code>'s <code>Sys</code> method)
- in the returned <a href="/pkg/archive/tar/#Header"><code>Header</code></a>.
- Now it also records the user and group names corresponding to those IDs,
- as well as the major and minor device numbers for device files.
- </p>
- <p>
- The new <a href="/pkg/archive/tar/#Header"><code>Header.Format</code></a> field
- of type <a href="/pkg/archive/tar/#Format"><code>Format</code></a>
- controls which tar header format the <a href="/pkg/archive/tar/#Writer"><code>Writer</code></a> uses.
- The default, as before, is to select the most widely-supported header type
- that can encode the fields needed by the header (USTAR if possible, or else PAX if possible, or else GNU).
- The <a href="/pkg/archive/tar/#Reader"><code>Reader</code></a> sets <code>Header.Format</code> for each header it reads.
- </p>
- <p>
- <code>Reader</code> and the <code>Writer</code> now support arbitrary PAX records,
- using the new <a href="/pkg/archive/tar/#Header"><code>Header.PAXRecords</code></a> field,
- a generalization of the existing <code>Xattrs</code> field.
- </p>
- <p>
- The <code>Reader</code> no longer insists that the file name or link name in GNU headers
- be valid UTF-8.
- </p>
- <p>
- When writing PAX- or GNU-format headers, the <code>Writer</code> now includes
- the <code>Header.AccessTime</code> and <code>Header.ChangeTime</code> fields (if set).
- When writing PAX-format headers, the times include sub-second precision.
- </p>
- </dl>
- <dl id="archive/zip"><dt><a href="/pkg/archive/zip/">archive/zip</a></dt>
- <dd>
- <p>
- Go 1.10 adds more complete support for times and character set encodings in ZIP archives.
- </p>
- <p>
- The original ZIP format used the standard MS-DOS encoding of year, month, day, hour, minute, and second into fields in two 16-bit values.
- That encoding cannot represent time zones or odd seconds, so multiple extensions have been
- introduced to allow richer encodings.
- In Go 1.10, the <a href="/pkg/archive/zip/#Reader"><code>Reader</code></a> and <a href="/pkg/archive/zip/#Writer"><code>Writer</code></a>
- now support the widely-understood Info-Zip extension that encodes the time separately in the 32-bit Unix “seconds since epoch” form.
- The <a href="/pkg/archive/zip/#FileHeader"><code>FileHeader</code></a>'s new <code>Modified</code> field of type <a href="/pkg/time/#Time"><code>time.Time</code></a>
- obsoletes the <code>ModifiedTime</code> and <code>ModifiedDate</code> fields, which continue to hold the MS-DOS encoding.
- The <code>Reader</code> and <code>Writer</code> now adopt the common
- convention that a ZIP archive storing a time zone-independent Unix time
- also stores the local time in the MS-DOS field,
- so that the time zone offset can be inferred.
- For compatibility, the <a href="/pkg/archive/zip/#FileHeader.ModTime"><code>ModTime</code></a> and
- <a href="/pkg/archive/zip/#FileHeader.SetModTime"><code>SetModTime</code></a> methods
- behave the same as in earlier releases; new code should use <code>Modified</code> directly.
- </p>
- <p>
- The header for each file in a ZIP archive has a flag bit indicating whether
- the name and comment fields are encoded as UTF-8, as opposed to a system-specific default encoding.
- In Go 1.8 and earlier, the <code>Writer</code> never set the UTF-8 bit.
- In Go 1.9, the <code>Writer</code> changed to set the UTF-8 bit almost always.
- This broke the creation of ZIP archives containing Shift-JIS file names.
- In Go 1.10, the <code>Writer</code> now sets the UTF-8 bit only when
- both the name and the comment field are valid UTF-8 and at least one is non-ASCII.
- Because non-ASCII encodings very rarely look like valid UTF-8, the new
- heuristic should be correct nearly all the time.
- Setting a <code>FileHeader</code>'s new <code>NonUTF8</code> field to true
- disables the heuristic entirely for that file.
- </p>
- <p>
- The <code>Writer</code> also now supports setting the end-of-central-directory record's comment field,
- by calling the <code>Writer</code>'s new <a href="/pkg/archive/zip/#Writer.SetComment"><code>SetComment</code></a> method.
- </p>
- </dl>
- <dl id="bufio"><dt><a href="/pkg/bufio/">bufio</a></dt>
- <dd>
- <p>
- The new <a href="/pkg/bufio/#Reader.Size"><code>Reader.Size</code></a>
- and <a href="/pkg/bufio/#Writer.Size"><code>Writer.Size</code></a>
- methods report the <code>Reader</code> or <code>Writer</code>'s underlying buffer size.
- </p>
- </dl>
- <dl id="bytes"><dt><a href="/pkg/bytes/">bytes</a></dt>
- <dd>
- <p>
- The
- <a href="/pkg/bytes/#Fields"><code>Fields</code></a>,
- <a href="/pkg/bytes/#FieldsFunc"><code>FieldsFunc</code></a>,
- <a href="/pkg/bytes/#Split"><code>Split</code></a>,
- and
- <a href="/pkg/bytes/#SplitAfter"><code>SplitAfter</code></a>
- functions have always returned subslices of their inputs.
- Go 1.10 changes each returned subslice to have capacity equal to its length,
- so that appending to one cannot overwrite adjacent data in the original input.
- </p>
- </dl>
- <dl id="crypto/cipher"><dt><a href="/pkg/crypto/cipher/">crypto/cipher</a></dt>
- <dd>
- <p>
- <a href="/pkg/crypto/cipher/#NewOFB"><code>NewOFB</code></a> now panics if given
- an initialization vector of incorrect length, like the other constructors in the
- package always have.
- (Previously it returned a nil <code>Stream</code> implementation.)
- </p>
- </dl>
- <dl id="crypto/tls"><dt><a href="/pkg/crypto/tls/">crypto/tls</a></dt>
- <dd>
- <p>
- The TLS server now advertises support for SHA-512 signatures when using TLS 1.2.
- The server already supported the signatures, but some clients would not select
- them unless explicitly advertised.
- </p>
- </dl>
- <dl id="crypto/x509"><dt><a href="/pkg/crypto/x509/">crypto/x509</a></dt>
- <dd>
- <p>
- <a href="/pkg/crypto/x509/#Certificate.Verify"><code>Certificate.Verify</code></a>
- now enforces the name constraints for all
- names contained in the certificate, not just the one name that a client has asked about.
- Extended key usage restrictions are similarly now checked all at once.
- As a result, after a certificate has been validated, now it can be trusted in its entirety.
- It is no longer necessary to revalidate the certificate for each additional name
- or key usage.
- </p>
- <p>
- Parsed certificates also now report URI names and IP, email, and URI constraints, using the new
- <a href="/pkg/crypto/x509/#Certificate"><code>Certificate</code></a> fields
- <code>URIs</code>, <code>PermittedIPRanges</code>, <code>ExcludedIPRanges</code>,
- <code>PermittedEmailAddresses</code>, <code>ExcludedEmailAddresses</code>,
- <code>PermittedURIDomains</code>, and <code>ExcludedURIDomains</code>. Certificates with
- invalid values for those fields are now rejected.
- </p>
- <p>
- The new <a href="/pkg/crypto/x509/#MarshalPKCS1PublicKey"><code>MarshalPKCS1PublicKey</code></a>
- and <a href="/pkg/crypto/x509/#ParsePKCS1PublicKey"><code>ParsePKCS1PublicKey</code></a>
- functions convert an RSA public key to and from PKCS#1-encoded form.
- </p>
- <p>
- The new <a href="/pkg/crypto/x509/#MarshalPKCS8PrivateKey"><code>MarshalPKCS8PrivateKey</code></a>
- function converts a private key to PKCS#8-encoded form.
- (<a href="/pkg/crypto/x509/#ParsePKCS8PrivateKey"><code>ParsePKCS8PrivateKey</code></a>
- has existed since Go 1.)
- </p>
- </dl>
- <dl id="crypto/x509/pkix"><dt><a href="/pkg/crypto/x509/pkix/">crypto/x509/pkix</a></dt>
- <dd>
- <p>
- <a href="/pkg/crypto/x509/pkix/#Name"><code>Name</code></a> now implements a
- <a href="/pkg/crypto/x509/pkix/#Name.String"><code>String</code></a> method that
- formats the X.509 distinguished name in the standard RFC 2253 format.
- </p>
- </dl>
- <dl id="database/sql/driver"><dt><a href="/pkg/database/sql/driver/">database/sql/driver</a></dt>
- <dd>
- <p>
- Drivers that currently hold on to the destination buffer provided by
- <a href="/pkg/database/sql/driver/#Rows.Next"><code>driver.Rows.Next</code></a> should ensure they no longer
- write to a buffer assigned to the destination array outside of that call.
- Drivers must be careful that underlying buffers are not modified when closing
- <a href="/pkg/database/sql/driver/#Rows"><code>driver.Rows</code></a>.
- </p>
- <p>
- Drivers that want to construct a <a href="/pkg/database/sql/#DB"><code>sql.DB</code></a> for
- their clients can now implement the <a href="/pkg/database/sql/driver/#Connector"><code>Connector</code></a> interface
- and call the new <a href="/pkg/database/sql/#OpenDB"><code>sql.OpenDB</code></a> function,
- instead of needing to encode all configuration into a string
- passed to <a href="/pkg/database/sql/#Open"><code>sql.Open</code></a>.
- </p>
- <p>
- Drivers that want to parse the configuration string only once per <code>sql.DB</code>
- instead of once per <a href="/pkg/database/sql/#Conn"><code>sql.Conn</code></a>,
- or that want access to each <code>sql.Conn</code>'s underlying context,
- can make their <a href="/pkg/database/sql/driver/#Driver"><code>Driver</code></a>
- implementations also implement <a href="/pkg/database/sql/driver/#DriverContext"><code>DriverContext</code></a>'s
- new <code>OpenConnector</code> method.
- </p>
- <p>
- Drivers that implement <a href="/pkg/database/sql/driver/#ExecerContext"><code>ExecerContext</code></a>
- no longer need to implement <a href="/pkg/database/sql/driver/#Execer"><code>Execer</code></a>;
- similarly, drivers that implement <a href="/pkg/database/sql/driver/#QueryerContext"><code>QueryerContext</code></a>
- no longer need to implement <a href="/pkg/database/sql/driver/#Queryer"><code>Queryer</code></a>.
- Previously, even if the context-based interfaces were implemented they were ignored
- unless the non-context-based interfaces were also implemented.
- </p>
- <p>
- To allow drivers to better isolate different clients using a cached driver connection in succession,
- if a <a href="/pkg/database/sql/driver/#Conn"><code>Conn</code></a> implements the new
- <a href="/pkg/database/sql/driver/#SessionResetter"><code>SessionResetter</code></a> interface,
- <code>database/sql</code> will now call <code>ResetSession</code> before
- reusing the <code>Conn</code> for a new client.
- </p>
- </dl>
- <dl id="debug/elf"><dt><a href="/pkg/debug/elf/">debug/elf</a></dt>
- <dd>
- <p>
- This release adds 348 new relocation constants divided between the relocation types
- <a href="/pkg/debug/elf/#R_386"><code>R_386</code></a>,
- <a href="/pkg/debug/elf/#R_AARCH64"><code>R_AARCH64</code></a>,
- <a href="/pkg/debug/elf/#R_ARM"><code>R_ARM</code></a>,
- <a href="/pkg/debug/elf/#R_PPC64"><code>R_PPC64</code></a>,
- and
- <a href="/pkg/debug/elf/#R_X86_64"><code>R_X86_64</code></a>.
- </p>
- </dl>
- <dl id="debug/macho"><dt><a href="/pkg/debug/macho/">debug/macho</a></dt>
- <dd>
- <p>
- Go 1.10 adds support for reading relocations from Mach-O sections,
- using the <a href="/pkg/debug/macho#Section"><code>Section</code></a> struct's new <code>Relocs</code> field
- and the new <a href="/pkg/debug/macho/#Reloc"><code>Reloc</code></a>,
- <a href="/pkg/debug/macho/#RelocTypeARM"><code>RelocTypeARM</code></a>,
- <a href="/pkg/debug/macho/#RelocTypeARM64"><code>RelocTypeARM64</code></a>,
- <a href="/pkg/debug/macho/#RelocTypeGeneric"><code>RelocTypeGeneric</code></a>,
- and
- <a href="/pkg/debug/macho/#RelocTypeX86_64"><code>RelocTypeX86_64</code></a>
- types and associated constants.
- </p>
- <p>
- Go 1.10 also adds support for the <code>LC_RPATH</code> load command,
- represented by the types
- <a href="/pkg/debug/macho/#RpathCmd"><code>RpathCmd</code></a> and
- <a href="/pkg/debug/macho/#Rpath"><code>Rpath</code></a>,
- and new <a href="/pkg/debug/macho/#pkg-constants">named constants</a>
- for the various flag bits found in headers.
- </p>
- </dl>
- <dl id="encoding/asn1"><dt><a href="/pkg/encoding/asn1/">encoding/asn1</a></dt>
- <dd>
- <p>
- <a href="/pkg/encoding/asn1/#Marshal"><code>Marshal</code></a> now correctly encodes
- strings containing asterisks as type UTF8String instead of PrintableString,
- unless the string is in a struct field with a tag forcing the use of PrintableString.
- <code>Marshal</code> also now respects struct tags containing <code>application</code> directives.
- </p>
- <p>
- The new <a href="/pkg/encoding/asn1/#MarshalWithParams"><code>MarshalWithParams</code></a>
- function marshals its argument as if the additional params were its associated
- struct field tag.
- </p>
- <p>
- <a href="/pkg/encoding/asn1/#Unmarshal"><code>Unmarshal</code></a> now respects
- struct field tags using the <code>explicit</code> and <code>tag</code>
- directives.
- </p>
- <p>
- Both <code>Marshal</code> and <code>Unmarshal</code> now support a new struct field tag
- <code>numeric</code>, indicating an ASN.1 NumericString.
- </p>
- </dl>
- <dl id="encoding/csv"><dt><a href="/pkg/encoding/csv/">encoding/csv</a></dt>
- <dd>
- <p>
- <a href="/pkg/encoding/csv/#Reader"><code>Reader</code></a> now disallows the use of
- nonsensical <code>Comma</code> and <code>Comment</code> settings,
- such as NUL, carriage return, newline, invalid runes, and the Unicode replacement character,
- or setting <code>Comma</code> and <code>Comment</code> equal to each other.
- </p>
- <p>
- In the case of a syntax error in a CSV record that spans multiple input lines, <code>Reader</code>
- now reports the line on which the record started in the <a href="/pkg/encoding/csv/#ParseError"><code>ParseError</code></a>'s new <code>StartLine</code> field.
- </p>
- </dl>
- <dl id="encoding/hex"><dt><a href="/pkg/encoding/hex/">encoding/hex</a></dt>
- <dd>
- <p>
- The new functions
- <a href="/pkg/encoding/hex/#NewEncoder"><code>NewEncoder</code></a>
- and
- <a href="/pkg/encoding/hex/#NewDecoder"><code>NewDecoder</code></a>
- provide streaming conversions to and from hexadecimal,
- analogous to equivalent functions already in
- <a href="/pkg/encoding/base32/">encoding/base32</a>
- and
- <a href="/pkg/encoding/base64/">encoding/base64</a>.
- </p>
- <p>
- When the functions
- <a href="/pkg/encoding/hex/#Decode"><code>Decode</code></a>
- and
- <a href="/pkg/encoding/hex/#DecodeString"><code>DecodeString</code></a>
- encounter malformed input,
- they now return the number of bytes already converted
- along with the error.
- Previously they always returned a count of 0 with any error.
- </p>
- </dl>
- <dl id="encoding/json"><dt><a href="/pkg/encoding/json/">encoding/json</a></dt>
- <dd>
- <p>
- The <a href="/pkg/encoding/json/#Decoder"><code>Decoder</code></a>
- adds a new method
- <a href="/pkg/encoding/json/#Decoder.DisallowUnknownFields"><code>DisallowUnknownFields</code></a>
- that causes it to report inputs with unknown JSON fields as a decoding error.
- (The default behavior has always been to discard unknown fields.)
- </p>
- <p>
- As a result of <a href="#reflect">fixing a reflect bug</a>,
- <a href="/pkg/encoding/json/#Unmarshal"><code>Unmarshal</code></a>
- can no longer decode into fields inside
- embedded pointers to unexported struct types,
- because it cannot initialize the unexported embedded pointer
- to point at fresh storage.
- <code>Unmarshal</code> now returns an error in this case.
- </p>
- </dl>
- <dl id="encoding/pem"><dt><a href="/pkg/encoding/pem/">encoding/pem</a></dt>
- <dd>
- <p>
- <a href="/pkg/encoding/pem/#Encode"><code>Encode</code></a>
- and
- <a href="/pkg/encoding/pem/#EncodeToMemory"><code>EncodeToMemory</code></a>
- no longer generate partial output when presented with a
- block that is impossible to encode as PEM data.
- </p>
- </dl>
- <dl id="encoding/xml"><dt><a href="/pkg/encoding/xml/">encoding/xml</a></dt>
- <dd>
- <p>
- The new function
- <a href="/pkg/encoding/xml/#NewTokenDecoder"><code>NewTokenDecoder</code></a>
- is like
- <a href="/pkg/encoding/xml/#NewDecoder"><code>NewDecoder</code></a>
- but creates a decoder reading from a <a href="/pkg/encoding/xml/#TokenReader"><code>TokenReader</code></a>
- instead of an XML-formatted byte stream.
- This is meant to enable the construction of XML stream transformers in client libraries.
- </p>
- </dl>
- <dl id="flag"><dt><a href="/pkg/flag/">flag</a></dt>
- <dd>
- <p>
- The default
- <a href="/pkg/flag/#Usage"><code>Usage</code></a> function now prints
- its first line of output to
- <code>CommandLine.Output()</code>
- instead of assuming <code>os.Stderr</code>,
- so that the usage message is properly redirected for
- clients using <code>CommandLine.SetOutput</code>.
- </p>
- <p>
- <a href="/pkg/flag/#PrintDefaults"><code>PrintDefaults</code></a> now
- adds appropriate indentation after newlines in flag usage strings,
- so that multi-line usage strings display nicely.
- </p>
- <p>
- <a href="/pkg/flag/#FlagSet"><code>FlagSet</code></a> adds new methods
- <a href="/pkg/flag/#FlagSet.ErrorHandling"><code>ErrorHandling</code></a>,
- <a href="/pkg/flag/#FlagSet.Name"><code>Name</code></a>,
- and
- <a href="/pkg/flag/#FlagSet.Output"><code>Output</code></a>,
- to retrieve the settings passed to
- <a href="/pkg/flag/#NewFlagSet"><code>NewFlagSet</code></a>
- and
- <a href="/pkg/flag/#FlagSet.SetOutput"><code>FlagSet.SetOutput</code></a>.
- </p>
- </dl>
- <dl id="go/doc"><dt><a href="/pkg/go/doc/">go/doc</a></dt>
- <dd>
- <p>
- To support the <a href="#doc">doc change</a> described above,
- functions returning slices of <code>T</code>, <code>*T</code>, <code>**T</code>, and so on
- are now reported in <code>T</code>'s <a href="/pkg/go/doc/#Type"><code>Type</code></a>'s <code>Funcs</code> list,
- instead of in the <a href="/pkg/go/doc/#Package"><code>Package</code></a>'s <code>Funcs</code> list.
- </p>
- </dl>
- <dl id="go/importer"><dt><a href="/pkg/go/importer/">go/importer</a></dt>
- <dd>
- <p>
- The <a href="/pkg/go/importer/#For"><code>For</code></a> function now accepts a non-nil lookup argument.
- </p>
- </dl>
- <dl id="go/printer"><dt><a href="/pkg/go/printer/">go/printer</a></dt>
- <dd>
- <p>
- The changes to the default formatting of Go source code
- discussed in the <a href="#gofmt">gofmt section</a> above
- are implemented in the <a href="/pkg/go/printer/">go/printer</a> package
- and also affect the output of the higher-level <a href="/pkg/go/format/">go/format</a> package.
- </p>
- </dl>
- <dl id="hash"><dt><a href="/pkg/hash/">hash</a></dt>
- <dd>
- <p>
- Implementations of the <a href="/pkg/hash/#Hash"><code>Hash</code></a> interface are now
- encouraged to implement <a href="/pkg/encoding/#BinaryMarshaler"><code>encoding.BinaryMarshaler</code></a>
- and <a href="/pkg/encoding/#BinaryUnmarshaler"><code>encoding.BinaryUnmarshaler</code></a>
- to allow saving and recreating their internal state,
- and all implementations in the standard library
- (<a href="/pkg/hash/crc32/">hash/crc32</a>, <a href="/pkg/crypto/sha256/">crypto/sha256</a>, and so on)
- now implement those interfaces.
- </p>
- </dl>
- <dl id="html/template"><dt><a href="/pkg/html/template/">html/template</a></dt>
- <dd>
- <p>
- The new <a href="/pkg/html/template#Srcset"><code>Srcset</code></a> content
- type allows for proper handling of values within the
- <a href="https://w3c.github.io/html/semantics-embedded-content.html#element-attrdef-img-srcset"><code>srcset</code></a>
- attribute of <code>img</code> tags.
- </p>
- </dl>
- <dl id="math/big"><dt><a href="/pkg/math/big/">math/big</a></dt>
- <dd>
- <p>
- <a href="/pkg/math/big/#Int"><code>Int</code></a> now supports conversions to and from bases 2 through 62
- in its <a href="/pkg/math/big/#Int.SetString"><code>SetString</code></a> and <a href="/pkg/math/big/#Text"><code>Text</code></a> methods.
- (Previously it only allowed bases 2 through 36.)
- The value of the constant <code>MaxBase</code> has been updated.
- </p>
- <p>
- <a href="/pkg/math/big/#Int"><code>Int</code></a> adds a new
- <a href="/pkg/math/big/#CmpAbs"><code>CmpAbs</code></a> method
- that is like <a href="/pkg/math/big/#Cmp"><code>Cmp</code></a> but
- compares only the absolute values (not the signs) of its arguments.
- </p>
- <p>
- <a href="/pkg/math/big/#Float"><code>Float</code></a> adds a new
- <a href="/pkg/math/big/#Float.Sqrt"><code>Sqrt</code></a> method to
- compute square roots.
- </p>
- </dl>
- <dl id="math/cmplx"><dt><a href="/pkg/math/cmplx/">math/cmplx</a></dt>
- <dd>
- <p>
- Branch cuts and other boundary cases in
- <a href="/pkg/math/cmplx/#Asin"><code>Asin</code></a>,
- <a href="/pkg/math/cmplx/#Asinh"><code>Asinh</code></a>,
- <a href="/pkg/math/cmplx/#Atan"><code>Atan</code></a>,
- and
- <a href="/pkg/math/cmplx/#Sqrt"><code>Sqrt</code></a>
- have been corrected to match the definitions used in the C99 standard.
- </p>
- </dl>
- <dl id="math/rand"><dt><a href="/pkg/math/rand/">math/rand</a></dt>
- <dd>
- <p>
- The new <a href="/pkg/math/rand/#Shuffle"><code>Shuffle</code></a> function and corresponding
- <a href="/pkg/math/rand/#Rand.Shuffle"><code>Rand.Shuffle</code></a> method
- shuffle an input sequence.
- </p>
- </dl>
- <dl id="math"><dt><a href="/pkg/math/">math</a></dt>
- <dd>
- <p>
- The new functions
- <a href="/pkg/math/#Round"><code>Round</code></a>
- and
- <a href="/pkg/math/#RoundToEven"><code>RoundToEven</code></a>
- round their arguments to the nearest floating-point integer;
- <code>Round</code> rounds a half-integer to its larger integer neighbor (away from zero)
- while <code>RoundToEven</code> rounds a half-integer to its even integer neighbor.
- </p>
- <p>
- The new functions
- <a href="/pkg/math/#Erfinv"><code>Erfinv</code></a>
- and
- <a href="/pkg/math/#Erfcinv"><code>Erfcinv</code></a>
- compute the inverse error function and the
- inverse complementary error function.
- </p>
- </dl>
- <dl id="mime/multipart"><dt><a href="/pkg/mime/multipart/">mime/multipart</a></dt>
- <dd>
- <p>
- <a href="/pkg/mime/multipart/#Reader"><code>Reader</code></a>
- now accepts parts with empty filename attributes.
- </p>
- </dl>
- <dl id="mime"><dt><a href="/pkg/mime/">mime</a></dt>
- <dd>
- <p>
- <a href="/pkg/mime/#ParseMediaType"><code>ParseMediaType</code></a> now discards
- invalid attribute values; previously it returned those values as empty strings.
- </p>
- </dl>
- <dl id="net"><dt><a href="/pkg/net/">net</a></dt>
- <dd>
- <p>
- The <a href="/pkg/net/#Conn"><code>Conn</code></a> and
- <a href="/pkg/net/#Conn"><code>Listener</code></a> implementations
- in this package now guarantee that when <code>Close</code> returns,
- the underlying file descriptor has been closed.
- (In earlier releases, if the <code>Close</code> stopped pending I/O
- in other goroutines, the closing of the file descriptor could happen in one of those
- goroutines shortly after <code>Close</code> returned.)
- </p>
- <p>
- <a href="/pkg/net/#TCPListener"><code>TCPListener</code></a> and
- <a href="/pkg/net/#UnixListener"><code>UnixListener</code></a>
- now implement
- <a href="/pkg/syscall/#Conn"><code>syscall.Conn</code></a>,
- to allow setting options on the underlying file descriptor
- using <a href="/pkg/syscall/#RawConn"><code>syscall.RawConn.Control</code></a>.
- </p>
- <p>
- The <code>Conn</code> implementations returned by <a href="/pkg/net/#Pipe"><code>Pipe</code></a>
- now support setting read and write deadlines.
- </p>
- <p>
- The <a href="/pkg/net/#IPConn.ReadMsgIP"><code>IPConn.ReadMsgIP</code></a>,
- <a href="/pkg/net/#IPConn.WriteMsgIP"><code>IPConn.WriteMsgIP</code></a>,
- <a href="/pkg/net/#UDPConn.ReadMsgUDP"><code>UDPConn.ReadMsgUDP</code></a>,
- and
- <a href="/pkg/net/#UDPConn.WriteMsgUDP"><code>UDPConn.WriteMsgUDP</code></a>,
- methods are now implemented on Windows.
- </p>
- </dl>
- <dl id="net/http"><dt><a href="/pkg/net/http/">net/http</a></dt>
- <dd>
- <p>
- On the client side, an HTTP proxy (most commonly configured by
- <a href="/pkg/net/http/#ProxyFromEnvironment"><code>ProxyFromEnvironment</code></a>)
- can now be specified as an <code>https://</code> URL,
- meaning that the client connects to the proxy over HTTPS before issuing a standard, proxied HTTP request.
- (Previously, HTTP proxy URLs were required to begin with <code>http://</code> or <code>socks5://</code>.)
- </p>
- <p>
- On the server side, <a href="/pkg/net/http/#FileServer"><code>FileServer</code></a> and its single-file equivalent <a href="/pkg/net/http/#ServeFile"><code>ServeFile</code></a>
- now apply <code>If-Range</code> checks to <code>HEAD</code> requests.
- <code>FileServer</code> also now reports directory read failures to the <a href="/pkg/net/http/#Server"><code>Server</code></a>'s <code>ErrorLog</code>.
- The content-serving handlers also now omit the <code>Content-Type</code> header when serving zero-length content.
- </p>
- <p>
- <a href="/pkg/net/http/#ResponseWriter"><code>ResponseWriter</code></a>'s <code>WriteHeader</code> method now panics
- if passed an invalid (non-3-digit) status code.
- </p>
- <p>
- <!-- CL 46631 -->
- The <code>Server</code> will no longer add an implicit Content-Type when a <code>Handler</code> does not write any output.
- </p>
- <p>
- <a href="/pkg/net/http/#Redirect"><code>Redirect</code></a> now sets the <code>Content-Type</code> header before writing its HTTP response.
- </p>
- </dl>
- <dl id="net/mail"><dt><a href="/pkg/net/mail/">net/mail</a></dt>
- <dd>
- <p>
- <a href="/pkg/net/mail/#ParseAddress"><code>ParseAddress</code></a> and
- <a href="/pkg/net/mail/#ParseAddressList"><code>ParseAddressList</code></a>
- now support a variety of obsolete address formats.
- </p>
- </dl>
- <dl id="net/smtp"><dt><a href="/pkg/net/smtp/">net/smtp</a></dt>
- <dd>
- <p>
- The <a href="/pkg/net/smtp/#Client"><code>Client</code></a> adds a new
- <a href="/pkg/net/smtp/#Client.Noop"><code>Noop</code></a> method,
- to test whether the server is still responding.
- It also now defends against possible SMTP injection in the inputs
- to the <a href="/pkg/net/smtp/#Client.Hello"><code>Hello</code></a>
- and <a href="/pkg/net/smtp/#Client.Verify"><code>Verify</code></a> methods.
- </p>
- </dl>
- <dl id="net/textproto"><dt><a href="/pkg/net/textproto/">net/textproto</a></dt>
- <dd>
- <p>
- <a href="/pkg/net/textproto/#ReadMIMEHeader"><code>ReadMIMEHeader</code></a>
- now rejects any header that begins with a continuation (indented) header line.
- Previously a header with an indented first line was treated as if the first line
- were not indented.
- </p>
- </dl>
- <dl id="net/url"><dt><a href="/pkg/net/url/">net/url</a></dt>
- <dd>
- <p>
- <a href="/pkg/net/url/#ResolveReference"><code>ResolveReference</code></a>
- now preserves multiple leading slashes in the target URL.
- Previously it rewrote multiple leading slashes to a single slash,
- which resulted in the <a href="/pkg/net/http/#Client"><code>http.Client</code></a>
- following certain redirects incorrectly.
- </p>
- <p>
- For example, this code's output has changed:
- </p>
- <pre>
- base, _ := url.Parse("http://host//path//to/page1")
- target, _ := url.Parse("page2")
- fmt.Println(base.ResolveReference(target))
- </pre>
- <p>
- Note the doubled slashes around <code>path</code>.
- In Go 1.9 and earlier, the resolved URL was <code>http://host/path//to/page2</code>:
- the doubled slash before <code>path</code> was incorrectly rewritten
- to a single slash, while the doubled slash after <code>path</code> was
- correctly preserved.
- Go 1.10 preserves both doubled slashes, resolving to <code>http://host//path//to/page2</code>
- as required by <a href="https://tools.ietf.org/html/rfc3986#section-5.2">RFC 3986</a>.
- </p>
- <p>This change may break existing buggy programs that unintentionally
- construct a base URL with a leading doubled slash in the path and inadvertently
- depend on <code>ResolveReference</code> to correct that mistake.
- For example, this can happen if code adds a host prefix
- like <code>http://host/</code> to a path like <code>/my/api</code>,
- resulting in a URL with a doubled slash: <code>http://host//my/api</code>.
- </p>
- <p>
- <a href="/pkg/net/url/#UserInfo"><code>UserInfo</code></a>'s methods
- now treat a nil receiver as equivalent to a pointer to a zero <code>UserInfo</code>.
- Previously, they panicked.
- </p>
- </dl>
- <dl id="os"><dt><a href="/pkg/os/">os</a></dt>
- <dd>
- <p>
- <a href="/pkg/os/#File"><code>File</code></a> adds new methods
- <a href="/pkg/os/#File.SetDeadline"><code>SetDeadline</code></a>,
- <a href="/pkg/os/#File.SetReadDeadline"><code>SetReadDeadline</code></a>,
- and
- <a href="/pkg/os/#File.SetWriteDeadline"><code>SetWriteDeadline</code></a>
- that allow setting I/O deadlines when the
- underlying file descriptor supports non-blocking I/O operations.
- The definition of these methods matches those in <a href="/pkg/net/#Conn"><code>net.Conn</code></a>.
- If an I/O method fails due to missing a deadline, it will return a
- timeout error; the
- new <a href="/pkg/os/#IsTimeout"><code>IsTimeout</code></a> function
- reports whether an error represents a timeout.
- </p>
- <p>
- Also matching <code>net.Conn</code>,
- <code>File</code>'s
- <a href="/pkg/os/#File.Close"><code>Close</code></a> method
- now guarantee that when <code>Close</code> returns,
- the underlying file descriptor has been closed.
- (In earlier releases,
- if the <code>Close</code> stopped pending I/O
- in other goroutines, the closing of the file descriptor could happen in one of those
- goroutines shortly after <code>Close</code> returned.)
- </p>
- <p>
- On BSD, macOS, and Solaris systems,
- <a href="/pkg/os/#Chtimes"><code>Chtimes</code></a>
- now supports setting file times with nanosecond precision
- (assuming the underlying file system can represent them).
- </p>
- </dl>
- <dl id="reflect"><dt><a href="/pkg/reflect/">reflect</a></dt>
- <dd>
- <p>
- The <a href="/pkg/reflect/#Copy"><code>Copy</code></a> function now allows copying
- from a string into a byte array or byte slice, to match the
- <a href="/pkg/builtin/#copy">built-in copy function</a>.
- </p>
- <p>
- In structs, embedded pointers to unexported struct types were
- previously incorrectly reported with an empty <code>PkgPath</code>
- in the corresponding <a href="/pkg/reflect/#StructField">StructField</a>,
- with the result that for those fields,
- and <a href="/pkg/reflect/#Value.CanSet"><code>Value.CanSet</code></a>
- incorrectly returned true and
- <a href="/pkg/reflect/#Value.Set"><code>Value.Set</code></a>
- incorrectly succeeded.
- The underlying metadata has been corrected;
- for those fields,
- <code>CanSet</code> now correctly returns false
- and <code>Set</code> now correctly panics.
- This may affect reflection-based unmarshalers
- that could previously unmarshal into such fields
- but no longer can.
- For example, see the <a href="#encoding/json"><code>encoding/json</code> notes</a>.
- </p>
- </dl>
- <dl id="runtime/pprof"><dt><a href="/pkg/runtime/pprof/">runtime/pprof</a></dt>
- <dd>
- <p>
- As <a href="#pprof">noted above</a>, the blocking and mutex profiles
- now include symbol information so that they can be viewed without needing
- the binary that generated them.
- </p>
- </dl>
- <dl id="strconv"><dt><a href="/pkg/strconv/">strconv</a></dt>
- <dd>
- <p>
- <a href="/pkg/strconv/#ParseUint"><code>ParseUint</code></a> now returns
- the maximum magnitude integer of the appropriate size
- with any <code>ErrRange</code> error, as it was already documented to do.
- Previously it returned 0 with <code>ErrRange</code> errors.
- </p>
- </dl>
- <dl id="strings"><dt><a href="/pkg/strings/">strings</a></dt>
- <dd>
- <p>
- A new type
- <a href="/pkg/strings/#Builder"><code>Builder</code></a> is a replacement for
- <a href="/pkg/bytes/#Buffer"><code>bytes.Buffer</code></a> for the use case of
- accumulating text into a <code>string</code> result.
- The <code>Builder</code>'s API is a restricted subset of <code>bytes.Buffer</code>'s
- that allows it to safely avoid making a duplicate copy of the data
- during the <a href="/pkg/strings/#Builder.String"><code>String</code></a> method.
- </p>
- </dl>
- <dl id="syscall"><dt><a href="/pkg/syscall/">syscall</a></dt>
- <dd>
- <p>
- On Windows,
- the new <a href="/pkg/syscall/#SysProcAttr"><code>SysProcAttr</code></a> field <code>Token</code>,
- of type <a href="/pkg/syscall/#Token"><code>Token</code></a> allows the creation of a process that
- runs as another user during <a href="/pkg/syscall/#StartProcess"><code>StartProcess</code></a>
- (and therefore also during <a href="/pkg/os/#StartProcess"><code>os.StartProcess</code></a> and
- <a href="/pkg/os/exec/#Cmd.Start"><code>exec.Cmd.Start</code></a>).
- The new function <a href="/pkg/syscall/#CreateProcessAsUser"><code>CreateProcessAsUser</code></a>
- gives access to the underlying system call.
- </p>
- <p>
- On BSD, macOS, and Solaris systems, <a href="/pkg/syscall/#UtimesNano"><code>UtimesNano</code></a>
- is now implemented.
- </p>
- </dl>
- <dl id="time"><dt><a href="/pkg/time/">time</a></dt>
- <dd>
- <p>
- <a href="/pkg/time/#LoadLocation"><code>LoadLocation</code></a> now uses the directory
- or uncompressed zip file named by the <code>$ZONEINFO</code>
- environment variable before looking in the default system-specific list of
- known installation locations or in <code>$GOROOT/lib/time/zoneinfo.zip</code>.
- </p>
- <p>
- The new function <a href="/pkg/time/#LoadLocationFromTZData"><code>LoadLocationFromTZData</code></a>
- allows conversion of IANA time zone file data to a <a href="/pkg/time/#Location"><code>Location</code></a>.
- </p>
- </dl>
- <dl id="unicode"><dt><a href="/pkg/unicode/">unicode</a></dt>
- <dd>
- <p>
- The <a href="/pkg/unicode/"><code>unicode</code></a> package and associated
- support throughout the system has been upgraded from Unicode 9.0 to
- <a href="http://www.unicode.org/versions/Unicode10.0.0/">Unicode 10.0</a>,
- which adds 8,518 new characters, including four new scripts, one new property,
- a Bitcoin currency symbol, and 56 new emoji.
- </p>
- </dl>
|