From: Brad Fitzpatrick Date: Tue, 13 Jun 2017 18:46:28 +0000 (+0000) Subject: doc: flesh out some more Go 1.9 package notes X-Git-Tag: go1.9beta1~32 X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=8546aa2e4b6a2898b52f5fd58f0e522ddf590572;p=gostls13.git doc: flesh out some more Go 1.9 package notes Change-Id: Ib6e2b858fcb15ea95fa8cfcba3bfac4e210605fe Reviewed-on: https://go-review.googlesource.com/45610 Reviewed-by: Alberto Donizetti Reviewed-by: Ian Lance Taylor --- diff --git a/doc/go1.9.html b/doc/go1.9.html index 28481e5d60..03ff12d2eb 100644 --- a/doc/go1.9.html +++ b/doc/go1.9.html @@ -236,19 +236,15 @@ type T1 = T2
archive/zip

- TODO: https://golang.org/cl/39570: set utf-8 flag + The + ZIP Writer + now sets the UTF-8 bit in + the FileHeader.Flags + when appropriate.

-
crypto
-
-

- TODO: https://golang.org/cl/36876: add BLAKE2b and BLAKE2s hash constants -

- -
-
crypto/aes

@@ -260,7 +256,11 @@ type T1 = T2

crypto/rand

- TODO: https://golang.org/cl/43852: use blocking getrandom call on Linux when supported + On Linux, Go now calls the getrandom system call + without the GRND_NONBLOCK flag; it will now block + until the kernel has sufficient randomness. On kernels predating + the getrandom system call, Go continues to read + from /dev/urandom.

@@ -268,11 +268,28 @@ type T1 = T2
crypto/x509

- TODO: https://golang.org/cl/36093: load certs from env vars + extra locations + + On UNIX systems the environment + variables SSL_CERT_FILE + and SSL_CERT_DIR can now be used to override the + system default locations for the SSL certificate file and SSL + certificate files directory, respectively. +

+ +

The FreeBSD path /usr/local/etc/ssl/cert.pem is + now included in the certificate search path.

- TODO: https://golang.org/cl/36900: support excluded domains in name constraints. + + The package now supports excluded domains in name constraints. + In addition to enforcing such constraints, + CreateCertificate + will create certificates with excluded name constraints + if the provided template certificate has the new + field + ExcludedDNSDomains + populated.

@@ -293,14 +310,6 @@ type T1 = T2
-
debug/dwarf
-
-

- TODO: https://golang.org/cl/44017: heuristically handle both UNIX and Windows paths -

- -
-
encoding/asn1

@@ -325,7 +334,12 @@ type T1 = T2

fmt

- TODO: https://golang.org/cl/37051: support sharp flag for float and complex value printing + The sharp flag ('#') is now supported when printing + floating point and complex numbers. It will always print a + decimal point + for %e, %E, %f, %F, %g + and %G; it will not remove trailing zeros + for %g and %G.

@@ -341,7 +355,9 @@ type T1 = T2
hash/fnv

- TODO: https://golang.org/cl/38356: add 128-bit FNV hash support + The package now includes 128-bit FNV-1 and FNV-1a hash support with + New128 and + New128a, respectively.

@@ -402,7 +418,13 @@ type T1 = T2
math/big

- TODO: https://golang.org/cl/36487: add IsInt64/IsUint64 predicates + The new + IsInt64 + and + IsUint64 + methods report whether an Int + may be represented as an int64 or uint64 + value.

@@ -410,7 +432,9 @@ type T1 = T2
mime/multipart

- TODO: https://golang.org/cl/39223: add Size to FileHeader + The new + FileHeader.Size + field describes the size of a file in a multipart message.

@@ -437,6 +461,16 @@ type T1 = T2 TODO: https://golang.org/cl/40512: validate network in Dial{,IP} and Listen{Packet,IP} for IP networks

+

+ The new methods + TCPConn.SyscallConn, + IPConn.SyscallConn, + UDPConn.SyscallConn, + and + UnixConn.SyscallConn + provide access to the connections' underlying file descriptors. +

+
net/http
@@ -610,15 +644,26 @@ type T1 = T2
syscall

- TODO: https://golang.org/cl/36697: only call setgroups if we need to + The new field + Credential.NoSetGroups + controls whether UNIX systems make a setgroups system call + to set supplementary groups when starting a new process.

- TODO: https://golang.org/cl/37439: use CLONE_VFORK and CLONE_VM + On 64-bit x86 Linux, process creation latency has been optimized with + use of CLONE_VFORK and CLONE_VM.

- TODO: https://golang.org/cl/37913: add Conn and RawConn interfaces + The new + Conn + interface describes some types in the + net + package that can provide access to their underlying file descriptor + using the new + RawConn + interface.

@@ -646,7 +691,11 @@ type T1 = T2
time

- TODO: https://golang.org/cl/36615: add Duration.Truncate and Duration.Round + The new methods + Duration.Round + and + Duration.Truncate + handle rounding durations away from and towards zero, respectively.