From 178d8d4f7ad1907cd9c0245b2ee4eacd5ae907df Mon Sep 17 00:00:00 2001 From: Rob Pike Date: Thu, 21 Mar 2013 13:51:49 -0700 Subject: [PATCH] doc/go1.1.html: more TODOs done Only the net stuff remains as significant work in the "minor changes" section. R=golang-dev, dave, elias.naur, rsc CC=golang-dev https://golang.org/cl/7933044 --- doc/go1.1.html | 115 ++++++++++++++++++++++++++++++++++++++----------- 1 file changed, 90 insertions(+), 25 deletions(-) diff --git a/doc/go1.1.html b/doc/go1.1.html index 8f6d8acc4c..df495ee81e 100644 --- a/doc/go1.1.html +++ b/doc/go1.1.html @@ -16,15 +16,15 @@ TODO The Go compatibility document 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 some +In the interest of firming up the specification, though, there are details about some error cases that have been clarified. -There is also some new language features. +There are also some new language features.

Integer division by zero

-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: 

@@ -214,7 +214,17 @@ package code.google.com/p/foo/quxx: cannot download, $GOPATH must not be set to

-TODO: go test uses -c with a profile flag. +The go test command no longer deletes the binary when run with profiling enabled, +to make it easier to analyze the profile. +The implementation sets the -c flag automatically, so after running, +

+ +
+$ go test -cpuprofile cpuprof.out mypackage
+
+ +

+the file mypackage.test will be left in the directory where go test was run.

Changes to go fix

@@ -421,24 +431,54 @@ The crypto/hmac package has a new f Equal, to compare two MACs. -
  • TODO: -crypto/x509: DecryptPEMBlock, EncryptPEMBlock etc. +
  • +The crypto/x509 package +now supports PEM blocks (see +DecryptPEMBlock for instance), +and a new function +ParseECPrivateKey to parse elliptic curve private keys.
    • -
  • TODO: -database/sql/driver: Queryer +
  • +The database/sql/ package +has a new +Ping +method for its +DB +type that tests the health of the connection.
    • -
  • TODO: -database/sql: Ping, SetMaxIdleConns +
  • +The database/sql/driver package +has a new +Queryer +interface that a +Conn +may implement to improve performance.
    • -
  • TODO: -encoding/json: Decoder.Buffered, UseNumber, Number +
  • +The encoding/json package's +Decoder +has a new method +Reader +to provide access to the remaining data in its buffer, +as well as a new method +UseNumber +to unmarshal a value into the new type +Number, +a string, rather than a float64.
    • -
  • TODO: -encoding/xml: EscapeText Encoder.Indent +
  • +The endoding/xml package +has a new function, +EscapeText, +which writes escaped XML output, +and a method on +Encoder, +Indent, +to specify indented output.
  • @@ -455,8 +495,15 @@ information that the godoc command can filter or present according to the value of the -notes flag.
    • -
  • TODO: -go/format: Node, Source +
  • +A new package, go/format, provides +a convenient way for a program to access the formatting capabilities of gofmt. +It has two functions, +Node to format a Go parser +Node, +and +Source +to format arbitrary Go source code.
  • @@ -498,8 +545,12 @@ and SetFloat64.
    • -
  • TODO: -mime/multipart: Writer.SetBoundary +
  • +The mime/multipart package +has a new method for its +Writer, +SetBoundary, +to define the boundary separator used to package the output.
  • @@ -518,11 +569,15 @@ The new net/http/cookiejar package provid net/smtp: Client.Hello
    • -
  • TODO: -net/textproto: TrimBytes, TrimString +
  • +The net/textproto package +has two new functions, +TrimBytes and +TrimString, +which do ASCII-only trimming of leading and trailing spaces.
    • -
  • +
  • TODO: net: DialOption, DialOpt, ListenUnixgram, LookupNS, IPConn.ReadMsgIP, IPConn.WriteMsgIP, UDPConn.ReadMsgUDP, UDPConn.WriteMsgUDP, UnixConn.CloseRead, UnixConn.CloseWrite
    • @@ -530,8 +585,9 @@ The new net/http/cookiejar package provid The new method os.FileMode.IsRegular makes it easy to ask if a file is a plain file. -
  • TODO: -pkg/image: new subsamplings +
  • +The image/jpeg package now +reads progressive JPEG files and handles a few more subsampling configurations.
  • @@ -543,8 +599,17 @@ method, while strings into pieces based on separators defined by the regular expression.
    • -
  • TODO: -runtime/debug: FreeOSMemory, ReadGCStats, SetGCPercent +
  • +The runtime/debug package +has three new functions regarding memory usage. +The FreeOSMemory +function triggers a run of the garbage collector and then attempts to return unused +memory to the operating system; +the ReadGCStats +function retrieves statistics about the collector; and +SetGCPercent +provides a programmatic way to control how often the collector runs, +including disabling it altogether.
  • -- 2.48.1