diff options
Diffstat (limited to 'doc/go1.1.html')
| -rw-r--r-- | doc/go1.1.html | 722 |
1 files changed, 668 insertions, 54 deletions
diff --git a/doc/go1.1.html b/doc/go1.1.html index ae0a09939..f1d490f41 100644 --- a/doc/go1.1.html +++ b/doc/go1.1.html @@ -12,12 +12,19 @@ TODO <h2 id="language">Changes to the language</h2> -TODO +<p> +<a href="/doc/go1compat.html">The Go compatibility document</a> promises +that programs written to the Go 1 language specification will continue to operate, +and those promises are maintained. +In the interest of firming up the specification, though, there are +details about some error cases that have been clarified. +There are also some new language features. +</p> <h3 id="divzero">Integer division by zero</h3> <p> -In Go 1, integer division by a constant zero produced a runtime panic: +In Go 1, integer division by a constant zero produced a run-time panic: </p> <pre> @@ -30,15 +37,93 @@ func f(x int) int { In Go 1.1, an integer division by constant zero is not a legal program, so it is a compile-time error. </p> +<h3 id="unicode_literals">Surrogates in Unicode literals</h3> -<h2 id="impl">Changes to the implementations and tools</h2> +<p> +The definition of string and rune literals has been refined to exclude surrogate halves from the +set of valid Unicode code points. +See the <a href="#unicode">Unicode</a> section for more information. +</p> -TODO: more +<h3 id="method_values">Method values</h3> -<h3 id="gc-flag">Command-line flag parsing</h3> +<p> +Go 1.1 now implements +<a href="/ref/spec#Method_values">method values</a>, +which are functions that have been bound to a specific receiver value. +For instance, given a +<a href="/pkg/bufio/#Writer"><code>Writer</code></a> +value <code>w</code>, +the expression +<code>w.Write</code>, +a method value, is a function that will always write to <code>w</code>; it is equivalent to +a function literal closing over <code>w</code>: +</p> + +<pre> +func (p []byte) (n int, err error) { + return w.Write(n, err) +} +</pre> <p> -In the gc toolchain, the compilers and linkers now use the +Method values are distinct from method expressions, which generate functions +from methods of a given type; the method expression <code>(*bufio.Writer).Write</code> +is equivalent to a function with an extra first argument, a receiver of type +<code>(*bufio.Writer)</code>: +</p> + +<pre> +func (w *bufio.Writer, p []byte) (n int, err error) { + return w.Write(n, err) +} +</pre> + +<p> +<em>Updating</em>: No existing code is affected; the change is strictly backward-compatible. +</p> + +<h3 id="return">Return requirements</h3> + +<p> +Before Go 1.1, a function that returned a value needed an explicit "return" +or call to <code>panic</code> at +the end of the function; this was a simple way to make the programmer +be explicit about the meaning of the function. But there are many cases +where a final "return" is clearly unnecessary, such as a function with +only an infinite "for" loop. +</p> + +<p> +In Go 1.1, the rule about final "return" statements is more permissive. +It introduces the concept of a +<a href="/ref/spec/#Terminating_statements"><em>terminating statement</em></a>, +a statement that is guaranteed to be the last one a function executes. +Examples include +"for" loops with no condition and "if-else" +statements in which each half ends in a "return". +If the final statement of a function can be shown <em>syntactically</em> to +be a terminating statement, no final "return" statement is needed. +</p> + +<p> +Note that the rule is purely syntactic: it pays no attention to the values in the +code and therefore requires no complex analysis. +</p> + +<p> +<em>Updating</em>: The change is backward-compatible, but existing code +with superfluous "return" statements and calls to <code>panic</code> may +be simplified manually. +Such code can be identified by <code>go vet</code>. +</p> + +<h2 id="impl">Changes to the implementations and tools</h2> + +<h3 id="gc_flag">Command-line flag parsing</h3> + +<p> +In the gc tool chain, the compilers and linkers now use the same command-line flag parsing rules as the Go flag package, a departure from the traditional Unix flag parsing. This may affect scripts that invoke the tool directly. @@ -50,7 +135,11 @@ For example, <h3 id="int">Size of int on 64-bit platforms</h3> <p> -The language allows the implementation to choose whether the <code>int</code> type and <code>uint</code> types are 32 or 64 bits. Previous Go implementations made <code>int</code> and <code>uint</code> 32 bits on all systems. Both the gc and gccgo implementations (TODO: check that gccgo does) <a href="http://golang.org/issue/2188">now make <code>int</code> and <code>uint</code> 64 bits on 64-bit platforms such as AMD64/x86-64</a>. +The language allows the implementation to choose whether the <code>int</code> type and +<code>uint</code> types are 32 or 64 bits. Previous Go implementations made <code>int</code> +and <code>uint</code> 32 bits on all systems. Both the gc and gccgo implementations +now make +<code>int</code> and <code>uint</code> 64 bits on 64-bit platforms such as AMD64/x86-64. Among other things, this enables the allocation of slices with more than 2 billion elements on 64-bit platforms. </p> @@ -59,7 +148,7 @@ more than 2 billion elements on 64-bit platforms. <em>Updating</em>: Most programs will be unaffected by this change. Because Go does not allow implicit conversions between distinct -<a href="/ref/spec#Numeric_types">numeric types</a>, +<a href="/ref/spec/#Numeric_types">numeric types</a>, no programs will stop compiling due to this change. However, programs that contain implicit assumptions that <code>int</code> is only 32 bits may change behavior. @@ -72,7 +161,7 @@ i := int(x) // i is -1 on 32-bit systems, 0xffffffff on 64-bit fmt.Println(i) </pre> -<p>Portable code intending 32-bit sign extension (yielding -1 on all systems) +<p>Portable code intending 32-bit sign extension (yielding <code>-1</code> on all systems) would instead say: </p> @@ -80,31 +169,100 @@ would instead say: i := int(int32(x)) </pre> -<h3 id="asm">Assembler</h3> +<h3 id="unicode">Unicode</h3> + +<p> +To make it possible to represent code points greater than 65535 in UTF-16, +Unicode defines <em>surrogate halves</em>, +a range of code points to be used only in the assembly of large values, and only in UTF-16. +The code points in that surrogate range are illegal for any other purpose. +In Go 1.1, this constraint is honored by the compiler, libraries, and run-time: +a surrogate half is illegal as a rune value, when encoded as UTF-8, or when +encoded in isolation as UTF-16. +When encountered, for example in converting from a rune to UTF-8, it is +treated as an encoding error and will yield the replacement rune, +<a href="/pkg/unicode/utf8/#RuneError"><code>utf8.RuneError</code></a>, +U+FFFD. +</p> + +<p> +This program, +</p> + +<pre> +import "fmt" + +func main() { + fmt.Printf("%+q\n", string(0xD800)) +} +</pre> + +<p> +printed <code>"\ud800"</code> in Go 1.0, but prints <code>"\ufffd"</code> in Go 1.1. +</p> + +<p> +Surrogate-half Unicode values are now illegal in rune and string constants, so constants such as +<code>'\ud800'</code> and <code>"\ud800"</code> are now rejected by the compilers. +When written explicitly as UTF-8 encoded bytes, +such strings can still be created, as in <code>"\xed\xa0\x80"</code>. +However, when such a string is decoded as a sequence of runes, as in a range loop, it will yield only <code>utf8.RuneError</code> +values. +</p> + +<p> +The Unicode byte order marks U+FFFE and U+FEFF, encoded in UTF-8, are now permitted as the first +character of a Go source file. +Even though their appearance in the byte-order-free UTF-8 encoding is clearly unnecessary, +some editors add them as a kind of "magic number" identifying a UTF-8 encoded file. +</p> + +<p> +<em>Updating</em>: +Most programs will be unaffected by the surrogate change. +Programs that depend on the old behavior should be modified to avoid the issue. +The byte-order-mark change is strictly backward-compatible. +</p> + +<h3 id="gc_asm">The gc assemblers</h3> <p> -Due to the <a href="#int">int</a> and TODO: OTHER changes, -the placement of function arguments on the stack has changed. +Due to the change of the <a href="#int"><code>int</code></a> to 64 bits and some other changes, +the arrangement of function arguments on the stack has changed in the gc tool chain. Functions written in assembly will need to be revised at least to adjust frame pointer offsets. </p> -<h3 id="gotool">Changes to the go tool</h3> +<p> +<em>Updating</em>: +The <code>go vet</code> command now checks that functions implemented in assembly +match the Go function prototypes they implement. +</p> + +<h3 id="gocmd">Changes to the go command</h3> -<p>The <code>go</code> tool has acquired several improvements which are intended to improve the experience for new Go users.</p> +<p> +The <a href="/cmd/go/"><code>go</code></a> command has acquired several +changes intended to improve the experience for new Go users. +</p> -<p>Firstly, when compiling, testing, or running Go code, the <code>go</code> tool will now give more detailed errors messages, including a list of paths searched, when a package cannot be located. +<p> +First, when compiling, testing, or running Go code, the <code>go</code> command will now give more detailed error messages, +including a list of paths searched, when a package cannot be located. </p> <pre> $ go build foo/quxx can't load package: package foo/quxx: cannot find package "foo/quxx" in any of: - /home/User/go/src/pkg/foo/quxx (from $GOROOT) - /home/User/src/foo/quxx (from $GOPATH) + /home/you/go/src/pkg/foo/quxx (from $GOROOT) + /home/you/src/foo/quxx (from $GOPATH) </pre> <p> -Secondly, the <code>go get</code> command no longer allows <code>$GOROOT</code> as the default destination when downloading package source. To use <code>go get</code> command, a valid <code>$GOPATH</code> is now required. +Second, the <code>go get</code> command no longer allows <code>$GOROOT</code> +as the default destination when downloading package source. +To use the <code>go get</code> +command, a valid <code>$GOPATH</code> is now required. </p> <pre> @@ -112,7 +270,9 @@ $ GOPATH= go get code.google.com/p/foo/quxx package code.google.com/p/foo/quxx: cannot download, $GOPATH not set. For more details see: go help gopath </pre> -<p>Finally, as a result of the previous change, the <code>go get</code> command will also fail when <code>$GOPATH</code> and <code>$GOROOT</code> are set to the same value. +<p> +Finally, as a result of the previous change, the <code>go get</code> command will also fail +when <code>$GOPATH</code> and <code>$GOROOT</code> are set to the same value. </p> <pre> @@ -121,68 +281,226 @@ warning: GOPATH set to GOROOT (/home/User/go) has no effect package code.google.com/p/foo/quxx: cannot download, $GOPATH must not be set to $GOROOT. For more details see: go help gopath </pre> -<h3 id="gofix">Changes to go fix</h3> +<h3 id="gotest">Changes to the go test command</h3> <p> -The <code>go fix</code> command no longer applies fixes to update code from -before Go 1 to use Go 1 APIs. To update pre-Go 1 code to Go 1.1, use a Go 1.0 toolchain +The <code>go test</code> command no longer deletes the binary when run with profiling enabled, +to make it easier to analyze the profile. +The implementation sets the <code>-c</code> flag automatically, so after running, +</p> + +<pre> +$ go test -cpuprofile cpuprof.out mypackage +</pre> + +<p> +the file <code>mypackage.test</code> will be left in the directory where <code>go test</code> was run. +</p> + +<p> +The <code>go test</code> command can now generate profiling information +that reports where goroutines are blocked, that is, +where they tend to stall waiting for an event such as a channel communication. +The information is presented as a +<em>blocking profile</em> +enabled with the +<code>-blockprofile</code> +option of +<code>go test</code>. +Run <code>go help test</code> for more information. +</p> + +<h3 id="gofix">Changes to the go fix command</h3> + +<p> +The <a href="/cmd/fix/"><code>fix</code></a> command, usually run as +<code>go fix</code>, no longer applies fixes to update code from +before Go 1 to use Go 1 APIs. +To update pre-Go 1 code to Go 1.1, use a Go 1.0 tool chain to convert the code to Go 1.0 first. </p> +<h2 id="performance">Performance</h2> + +<p> +TODO introduction +</p> + +<ul> +<li>TODO better code generation (inlining, ...?)</li> +<li>TODO parallel gc</li> +<li>TODO more precise gc</li> +<li>TODO networking is more efficient (known to runtime)</li> +</ul> + <h2 id="library">Changes to the standard library</h2> -<h3 id="debug_elf">debug/elf</h3> +<h3 id="bufio_scanner">bufio.Scanner</h3> + <p> -Previous versions of the debug/elf package intentionally skipped over the first -symbol in the ELF symbol table, since it is always an empty symbol. This symbol -is no longer skipped since indexes into the symbol table returned by debug/elf, -will be different to indexes into the original ELF symbol table. Any code that -calls the debug/elf functions Symbols or ImportedSymbols may need to be -adjusted to account for the additional symbol and the change in symbol offsets. +The various routines to scan textual input in the +<a href="/pkg/bufio/"><code>bufio</code></a> +package, +<a href="/pkg/bufio/#Reader.ReadBytes"><code>ReadBytes</code></a>, +<a href="/pkg/bufio/#Reader.ReadString"><code>ReadString</code></a> +and particularly +<a href="/pkg/bufio/#Reader.ReadLine"><code>ReadLine</code></a>, +are needlessly complex to use for simple purposes. +In Go 1.1, a new type, +<a href="/pkg/bufio/#Scanner"><code>Scanner</code></a>, +has been added to make it easier to do simple tasks such as +read the input as a sequence of lines or space-delimited words. +It simplifies the problem by terminating the scan on problematic +input such as pathologically long lines, and having a simple +default: line-oriented input, with each line stripped of its terminator. +Here is code to reproduce the input a line at a time: </p> -<h3 id="html_template">html/template</h3> +<pre> +scanner := bufio.NewScanner(os.Stdin) +for scanner.Scan() { + fmt.Println(scanner.Text()) // Println will add back the final '\n' +} +if err := scanner.Err(); err != nil { + fmt.Fprintln(os.Stderr, "reading standard input:", err) +} +</pre> <p> -Templates using the undocumented and only partially implemented -"noescape" feature will break: that feature was removed. +Scanning behavior can be adjusted through a function to control subdividing the input +(see the documentation for <a href="/pkg/bufio/#SplitFunc"><code>SplitFunc</code></a>), +but for tough problems or the need to continue past errors, the older interface +may still be required. </p> <h3 id="net">net</h3> <p> -The protocol-specific resolvers were formerly -lax about the network name passed in. For example, although the documentation was clear -that the only valid networks for <code>ResolveTCPAddr</code> are <code>"tcp"</code>, -<code>"tcp4"</code>, and <code>"tcp6"</code>, the Go 1.0 implementation silently accepted -any string. The Go 1.1 implementation returns an error if the network is not one of those strings. -The same is true of the other protocol-specific resolvers <code>ResolveIPAddr</code>, <code>ResolveUDPAddr</code>, and -<code>ResolveUnixAddr</code>. +The protocol-specific resolvers in the <a href="/pkg/net/"><code>net</code></a> package were formerly +lax about the network name passed in. +Although the documentation was clear +that the only valid networks for +<a href="/pkg/net/#ResolveTCPAddr"><code>ResolveTCPAddr</code></a> +are <code>"tcp"</code>, +<code>"tcp4"</code>, and <code>"tcp6"</code>, the Go 1.0 implementation silently accepted any string. +The Go 1.1 implementation returns an error if the network is not one of those strings. +The same is true of the other protocol-specific resolvers <a href="/pkg/net/#ResolveIPAddr"><code>ResolveIPAddr</code></a>, +<a href="/pkg/net/#ResolveUDPAddr"><code>ResolveUDPAddr</code></a>, and +<a href="/pkg/net/#ResolveUnixAddr"><code>ResolveUnixAddr</code></a>. </p> <p> -The previous <code>ListenUnixgram</code> returned <code>UDPConn</code> as -arepresentation of the connection endpoint. The Go 1.1 implementation -returns <code>UnixConn</code> to allow reading and writing -with <code>ReadFrom</code> and <code>WriteTo</code> methods on -the <code>UnixConn</code>. +The previous implementation of +<a href="/pkg/net/#ListenUnixgram"><code>ListenUnixgram</code></a> +returned a +<a href="/pkg/net/#UDPConn"><code>UDPConn</code></a> as +a representation of the connection endpoint. +The Go 1.1 implementation instead returns a +<a href="/pkg/net/#UnixConn"><code>UnixConn</code></a> +to allow reading and writing +with its +<a href="/pkg/net/#UnixConn.ReadFrom"><code>ReadFrom</code></a> +and +<a href="/pkg/net/#UnixConn.WriteTo"><code>WriteTo</code></a> +methods. +</p> + +<h3 id="reflect">reflect</h3> + +<p> +The <a href="/pkg/reflect/"><code>reflect</code></a> package has several significant additions. </p> +<p> +It is now possible to run a "select" statement using +the <code>reflect</code> package; see the description of +<a href="/pkg/reflect/#Select"><code>Select</code></a> +and +<a href="/pkg/reflect/#SelectCase"><code>SelectCase</code></a> +for details. +</p> + +<p> +The new method +<a href="/pkg/reflect/#Value.Convert"><code>Value.Convert</code></a> +(or +<a href="/pkg/reflect/#Type"><code>Type.ConvertibleTo</code></a>) +provides functionality to execute a Go conversion or type assertion operation +on a +<a href="/pkg/reflect/#Value"><code>Value</code></a> +(or test for its possibility). +</p> + +<p> +The new function +<a href="/pkg/reflect/#MakeFunc"><code>MakeFunc</code></a> +creates a wrapper function to make it easier to call a function with existing +<a href="/pkg/reflect/#Value"><code>Values</code></a>, +doing the standard Go conversions among the arguments, for instance +to pass an actual <code>int</code> to a formal <code>interface{}</code>. +</p> + +<p> +Finally, the new functions +<a href="/pkg/reflect/#ChanOf"><code>ChanOf</code></a>, +<a href="/pkg/reflect/#MapOf"><code>MapOf</code></a> +and +<a href="/pkg/reflect/#SliceOf"><code>SliceOf</code></a> +construct new +<a href="/pkg/reflect/#Type"><code>Types</code></a> +from existing types, for example to construct a the type <code>[]T</code> given +only <code>T</code>. +</p> + + <h3 id="time">time</h3> <p> -On FreeBSD, Linux, NetBSD, OS X and OpenBSD, previous versions of the time package -returned times with microsecond precision. The Go 1.1 implementation of time on these -systems now returns times with nanosecond precision. Code may exist that expects to be -able to store such a time in an external format with only microsecond precision, -read it back, and recover exactly the same time instant. -In Go 1.1 the same time will not be recovered, since the external storage -will have discarded nanoseconds. -To address this case, there are two new methods of time.Time, Round and Truncate, +On FreeBSD, Linux, NetBSD, OS X and OpenBSD, previous versions of the +<a href="/pkg/time/"><code>time</code></a> package +returned times with microsecond precision. +The Go 1.1 implementation on these +systems now returns times with nanosecond precision. +Programs that write to an external format with microsecond precision +and read it back, expecting to recover the original value, will be affected +by the loss of precision. +There are two new methods of <a href="/pkg/time/#Time"><code>Time</code></a>, +<a href="/pkg/time/#Time.Round"><code>Round</code></a> +and +<a href="/pkg/time/#Time.Truncate"><code>Truncate</code></a>, that can be used to remove precision from a time before passing it to external storage. </p> -<h3 id="exp_old">Exp and old subtrees moved to go.exp subrepo</h3> +<p> +The new method +<a href="/pkg/time/#Time.YearDay"><code>YearDay</code></a> +returns the one-indexed integral day number of the year specified by the time value. +</p> + +<p> +The +<a href="/pkg/time/#Timer"><code>Timer</code></a> +type has a new method +<a href="/pkg/time/#Timer.Reset"><code>Reset</code></a> +that modifies the timer to expire after a specified duration. +</p> + +<p> +Finally, the new function +<a href="/pkg/time/#ParseInLocation"><code>ParseInLocation</code></a> +is like the existing +<a href="/pkg/time/#Parse"><code>Parse</code></a> +but parses the time in the context of a location (time zone), ignoring +time zone information in the parsed string. +This function addresses a common source of confusion in the time API. +</p> + +<p> +<em>Updating</em>: +Code that needs to read and write times using an external format with +lower precision should be modified to use the new methods. + +<h3 id="exp_old">Exp and old subtrees moved to go.exp and go.text subrepositories</h3> <p> To make it easier for binary distributions to access them if desired, the <code>exp</code> @@ -204,4 +522,300 @@ and then in Go source, import "code.google.com/p/go.exp/ssa" </pre> -<h3 id="TODO">TODO</h3> +<p> +The old package <code>exp/norm</code> has also been moved, but to a new repository +<code>go.text</code>, where the Unicode APIs and other text-related packages will +be developed. +</p> + +<h3 id="minor_library_changes">Minor changes to the library</h3> + +<p> +The following list summarizes a number of minor changes to the library, mostly additions. +See the relevant package documentation for more information about each change. +</p> + +<ul> +<li> +The <a href="/pkg/bytes/"><code>bytes</code></a> package has two new functions, +<a href="/pkg/bytes/#TrimPrefix"><code>TrimPrefix</code></a> +and +<a href="/pkg/bytes/#TrimSuffix"><code>TrimSuffix</code></a>, +with self-evident properties. +Also, the <a href="/pkg/bytes/#Buffer"><code>Buffer</code></a> type +has a new method +<a href="/pkg/bytes/#Buffer.Grow"><code>Grow</code></a> that +provides some control over memory allocation inside the buffer. +Finally, the +<a href="/pkg/bytes/#Reader"><code>Reader</code></a> type now has a +<a href="/pkg/strings/#Reader.WriteTo"><code>WriteTo</code></a> method +so it implements the +<a href="/pkg/io/#WriterTo"><code>io.WriterTo</code></a> interface. +</li> + +<li> +The <a href="/pkg/crypto/hmac/"><code>crypto/hmac</code></a> package has a new function, +<a href="/pkg/crypto/hmac/#Equal"><code>Equal</code></a>, to compare two MACs. +</li> + +<li> +The <a href="/pkg/crypto/x509/"><code>crypto/x509</code></a> package +now supports PEM blocks (see +<a href="/pkg/crypto/x509/#DecryptPEMBlock"><code>DecryptPEMBlock</code></a> for instance), +and a new function +<a href="/pkg/crypto/x509/#ParseECPrivateKey"><code>ParseECPrivateKey</code></a> to parse elliptic curve private keys. +</li> + +<li> +The <a href="/pkg/database/sql/"><code>database/sql/</code></a> package +has a new +<a href="/pkg/database/sql/#DB.Ping"><code>Ping</code></a> +method for its +<a href="/pkg/database/sql/#DB"><code>DB</code></a> +type that tests the health of the connection. +</li> + +<li> +The <a href="/pkg/database/sql/driver/"><code>database/sql/driver</code></a> package +has a new +<a href="/pkg/database/sql/driver/#Queryer"><code>Queryer</code></a> +interface that a +<a href="/pkg/database/sql/driver/#Conn"><code>Conn</code></a> +may implement to improve performance. +</li> + +<li> +The <a href="/pkg/encoding/json/"><code>encoding/json</code></a> package's +<a href="/pkg/encoding/json/#Decoder"><code>Decoder</code></a> +has a new method +<a href="/pkg/encoding/json/#Decoder.Reader"><code>Reader</code></a> +to provide access to the remaining data in its buffer, +as well as a new method +<a href="/pkg/encoding/json/#Decoder.UseNumber"><code>UseNumber</code></a> +to unmarshal a value into the new type +<a href="/pkg/encoding/json/#Number"><code>Number</code></a>, +a string, rather than a float64. +</li> + +<li> +The <a href="/pkg/encoding/xml/"><code>endoding/xml</code></a> package +has a new function, +<a href="/pkg/encoding/xml/#EscapeText"><code>EscapeText</code></a>, +which writes escaped XML output, +and a method on +<a href="/pkg/encoding/xml/#Encoder"><code>Encoder</code></a>, +<a href="/pkg/encoding/xml/#Encoder.Indent"><code>Indent</code></a>, +to specify indented output. +</li> + +<li> +In the <a href="/pkg/go/ast/"><code>go/ast</code></a> package, a +new type <a href="/pkg/go/ast/#CommentMap"><code>CommentMap</code></a> +and associated methods makes it easier to extract and process comments in Go programs. +</li> + +<li> +In the <a href="/pkg/go/doc/"><code>go/doc</code></a> package, +the parser now keeps better track of stylized annotations such as <code>TODO(joe)</code> +throughout the code, +information that the <a href="/cmd/godoc/"><code>godoc</code></a> +command can filter or present according to the value of the <code>-notes</code> flag. +</li> + +<li> +A new package, <a href="/pkg/go/format/"><code>go/format</code></a>, provides +a convenient way for a program to access the formatting capabilities of <code>gofmt</code>. +It has two functions, +<a href="/pkg/go/format/#Node"><code>Node</code></a> to format a Go parser +<a href="/pkg/go/ast/#Node"><code>Node</code></a>, +and +<a href="/pkg/go/format/#Source"><code>Source</code></a> +to format arbitrary Go source code. +</li> + +<li> +The undocumented and only partially implemented "noescape" feature of the +<a href="/pkg/html/template/">html/template</a> +package has been removed; programs that depend on it will break. +</li> + +<li> +The <a href="/pkg/io/">io</a> package now exports the +<a href="/pkg/io/#ByteWriter"><code>io.ByteWriter</code></a> interface to capture the common +functionality of writing a byte at a time. +</li> + +<li> +The <a href="/pkg/log/syslog/"><code>log/syslog</code></a> package now provides better support +for OS-specific logging features. +</li> + +<li> +The <a href="/pkg/math/big/"><code>math/big</code></a> package's +<a href="/pkg/math/big/#Int"><code>Int</code></a> type now has +now has methods +<a href="/pkg/math/big/#Int.MarshalJSON"><code>MarshalJSON</code></a> +and +<a href="/pkg/math/big/#Int.UnmarshalJSON"><code>UnmarshalJSON</code></a> +to convert to and from a JSON representation. +Also, +<a href="/pkg/math/big/#Int"><code>Int</code></a> +can now convert directly to and from a <code>uint64</code> using +<a href="/pkg/math/big/#Int.Uint64"><code>Uint64</code></a> +and +<a href="/pkg/math/big/#Int.SetUint64"><code>SetUint64</code></a>, +while +<a href="/pkg/math/big/#Rat"><code>Rat</code></a> +can do the same with <code>float64</code> using +<a href="/pkg/math/big/#Rat.Float64"><code>Float64</code></a> +and +<a href="/pkg/math/big/#Rat.SetFloat64"><code>SetFloat64</code></a>. +</li> + +<li> +The <a href="/pkg/mime/multipart/"><code>mime/multipart</code></a> package +has a new method for its +<a href="/pkg/mime/multipart/#Writer"><code>Writer</code></a>, +<a href="/pkg/mime/multipart/#Writer.SetBoundary"><code>SetBoundary</code></a>, +to define the boundary separator used to package the output. +</li> + +<li> +The +<a href="/pkg/net/"><code>net</code></a> package's +<a href="/pkg/net/#ListenUnixgram"><code>net/ListenUnixgram</code></a> +function has changed return types: it now returns a +<a href="/pkg/net/#UnixConn"><code>net/UnixConn</code></a> +rather than a +<a href="/pkg/net/#UDPConn"><code>net/UDPConn</code></a>, which was +clearly a mistake in Go 1.0. +Since this API change fixes a bug, it is permitted by the Go 1 compatibility rules. +</li> + +<li> +The new <a href="/pkg/net/http/cookiejar/">net/http/cookiejar</a> package provides the basics for managing HTTP cookies. +</li> + +<li> TODO: +<code>net/http</code>: ParseTime, CloseNotifier, Request.PostFormValue, ServeMux.Handler, Transport.CancelRequest +</li> + +<li> TODO: +<code>net/mail</code>: ParseAddress, ParseAddressList +</li> + +<li> TODO: +<code>net/smtp</code>: Client.Hello +</li> + +<li> +The <a href="/pkg/net/textproto/"><code>net/textproto</code></a> package +has two new functions, +<a href="/pkg/net/textproto/#TrimBytes"><code>TrimBytes</code></a> and +<a href="/pkg/net/textproto/#TrimString"><code>TrimString</code></a>, +which do ASCII-only trimming of leading and trailing spaces. +</li> + +<li> TODO: +<code>net</code>: DialOption, DialOpt, ListenUnixgram, LookupNS, IPConn.ReadMsgIP, IPConn.WriteMsgIP, UDPConn.ReadMsgUDP, UDPConn.WriteMsgUDP, UnixConn.CloseRead, UnixConn.CloseWrite +</li> + +<li> +The new method <a href="/pkg/os/#FileMode.IsRegular"><code>os.FileMode.IsRegular</code> </a> makes it easy to ask if a file is a plain file. +</li> + +<li> +The <a href="/pkg/image/jpeg/"><code>image/jpeg</code></a> package now +reads progressive JPEG files and handles a few more subsampling configurations. +</li> + +<li> +The <a href="/pkg/regexp/"><code>regexp</code></a> package +now supports Unix-original leftmost-longest matches through the +<a href="/pkg/regexp/#Regexp.Longest"><code>Regexp.Longest</code></a> +method, while +<a href="/pkg/regexp/#Regexp.Split"><code>Regexp.Split</code></a> slices +strings into pieces based on separators defined by the regular expression. +</li> + +<li> +The <a href="/pkg/runtime/debug/"><code>runtime/debug</code></a> package +has three new functions regarding memory usage. +The <a href="/pkg/runtime/debug/#FreeOSMemory"><code>FreeOSMemory</code></a> +function triggers a run of the garbage collector and then attempts to return unused +memory to the operating system; +the <a href="/pkg/runtime/debug/#ReadGCStats"><code>ReadGCStats</code></a> +function retrieves statistics about the collector; and +<a href="/pkg/runtime/debug/#SetGCPercent"><code>SetGCPercent</code></a> +provides a programmatic way to control how often the collector runs, +including disabling it altogether. +</li> + +<li> +The <a href="/pkg/sort/"><code>sort</code></a> package has a new function, +<a href="/pkg/sort/#Reverse"><code>Reverse</code></a>. +Wrapping the argument of a call to +<a href="/pkg/sort/#Sort"><code>sort.Sort</code></a> +with a call to <code>Reverse</code> causes the sort order to be reversed. +</li> + +<li> +The <a href="/pkg/strings/"><code>strings</code></a> package has two new functions, +<a href="/pkg/strings/#TrimPrefix"><code>TrimPrefix</code></a> +and +<a href="/pkg/strings/#TrimSuffix"><code>TrimSuffix</code></a> +with self-evident properties, and the the new method +<a href="/pkg/strings/#Reader.WriteTo"><code>Reader.WriteTo</code></a> so the +<a href="/pkg/strings/#Reader"><code>Reader</code></a> +type now implements the +<a href="/pkg/io/#WriterTo"><code>io.WriterTo</code></a> interface. +</li> + +<li> +The <a href="/pkg/syscall/"><code>syscall</code></a> package has received many updates to make it more inclusive of constants and system calls for each supported operating system. +</li> + +<li> +The <a href="/pkg/testing/"><code>testing</code></a> package now automates the generation of allocation +statistics in benchmarks using the new +<a href="/pkg/testing/#AllocsPerRun"><code>AllocsPerRun</code></a> function and the +<a href="/pkg/testing/#BenchmarkResult.AllocsPerOp"><code>AllocsPerOp</code></a> method of +<a href="/pkg/testing/#BenchmarkResult"><code>BenchmarkResult</code></a>. +There is also a new +<a href="/pkg/testing/#Verbose"><code>Verbose</code></a> function to test the state of the <code>-v</code> +command-line flag, +and a new +<a href="/pkg/testing/#B.Skip"><code>Skip</code></a> method of +<a href="/pkg/testing/#B"><code>testing.B</code></a> and +<a href="/pkg/testing/#T"><code>testing.T</code></a> +to simplify skipping an inappropriate test. +</li> + +<li> +In the <a href="/pkg/text/template/"><code>text/template</code></a> +and +<a href="/pkg/html/template/"><code>html/template</code></a> packages, +templates can now use parentheses to group the elements of pipelines, simplifying the construction of complex pipelines. +TODO: Link to example. +Also, as part of the new parser, the +<a href="/pkg/text/template/parse/#Node"><code>Node</code></a> interface got two new methods to provide +better error reporting. +Although this violates the Go 1 compatibility rules, +no existing code should be affected because this interface is explicitly intended only to be used +by the +<a href="/pkg/text/template/"><code>text/template</code></a> +and +<a href="/pkg/html/template/"><code>html/template</code></a> +packages and there are safeguards to guarantee that. +</li> + +<li> +In the <a href="/pkg/unicode/utf8/"><code>unicode/utf8</code></a> package, +the new function <a href="/pkg/unicode/utf8/#ValidRune"><code>ValidRune</code></a> reports whether the rune is a valid Unicode code point. +To be valid, a rune must be in range and not be a surrogate half. +</li> + +<li> +The implementation of the <a href="/pkg/unicode/"><code>unicode</code></a> package has been updated to Unicode version 6.2.0. +</li> +</ul> |