diff options
author | Austin Clements <austin@google.com> | 2020-06-05 09:46:21 -0400 |
---|---|---|
committer | Austin Clements <austin@google.com> | 2020-06-07 19:24:28 +0000 |
commit | 666448abebed5c165b90814a0f4146a8ae084fb0 (patch) | |
tree | 5165389ac62b4ac8e660491ab71a1b86c9e60925 | |
parent | acdd111e320363c77eb04a761f0b7d4a9dd64c22 (diff) | |
download | go-666448abebed5c165b90814a0f4146a8ae084fb0.tar.gz go-666448abebed5c165b90814a0f4146a8ae084fb0.zip |
doc/go1.15: rationalize runtime sections
Use the "Core library -> runtime" section for changes that affect the
runtime package API and use the top-level "Runtime" section for
package-independent behavior changes. Also, move the one change that's
really about os (and net) into the "os" package section and reword it
to be more accurate.
Updates #37419.
Change-Id: I32896b039f29ac67308badd0d0b36e8c6e39f64f
Reviewed-on: https://go-review.googlesource.com/c/go/+/236718
Reviewed-by: Michael Knyszek <mknyszek@google.com>
-rw-r--r-- | doc/go1.15.html | 72 |
1 files changed, 35 insertions, 37 deletions
diff --git a/doc/go1.15.html b/doc/go1.15.html index 19f124ae00..34ce3e58ce 100644 --- a/doc/go1.15.html +++ b/doc/go1.15.html @@ -218,10 +218,24 @@ Do not send CLs removing the interior tags from such phrases. <h2 id="runtime">Runtime</h2> -<p><!-- CL 232862 --> - Go now retries system calls that return <code>EINTR</code>. This - became more common in Go 1.14 with the addition of asynchronous - preemption, but is now handled transparently. +<p><!-- CL 221779 --> + If <code>panic</code> is invoked with a value whose type is derived from any + of: <code>bool</code>, <code>complex64</code>, <code>complex128</code>, <code>float32</code>, <code>float64</code>, + <code>int</code>, <code>int8</code>, <code>int16</code>, <code>int32</code>, <code>int64</code>, <code>string</code>, + <code>uint</code>, <code>uint8</code>, <code>uint16</code>, <code>uint32</code>, <code>uint64</code>, <code>uintptr</code>, + then the value will be printed, instead of just its address. + Previously, this was only true for values of exactly these types. +</p> + +<p><!-- CL 228900 --> + On a Unix system, if the <code>kill</code> command + or <code>kill</code> system call is used to send + a <code>SIGSEGV</code>, <code>SIGBUS</code>, + or <code>SIGFPE</code> signal to a Go program, and if the signal + is not being handled via + <a href="/pkg/os/signal/#Notify"><code>os/signal.Notify</code></a>, + the Go program will now reliably crash with a stack trace. + In earlier releases the behavior was unpredictable. </p> <p><!-- CL 221182, CL 229998 --> @@ -229,8 +243,14 @@ Do not send CLs removing the interior tags from such phrases. counts, and has lower worst-case latency. </p> -<p> -TODO +<p><!-- CL 216401 --> + Converting a small integer value into an interface value no longer + causes allocation. +</p> + +<p><!-- CL 216818 --> + Non-blocking receives on closed channels now perform as well as + non-blocking receives on open channels. </p> <h2 id="compiler">Compiler</h2> @@ -540,6 +560,14 @@ TODO which <code>Timeout</code> returns <code>true</code> although a deadline has not been exceeded. </p> + + <p><!-- CL 232862 --> + Packages <code>os</code> and <code>net</code> now automatically + retry system calls that fail with <code>EINTR</code>. Previously + this led to spurious failures, which became more common in Go + 1.14 with the addition of asynchronous preemption. Now this is + handled transparently. + </p> </dd> </dl> @@ -559,7 +587,7 @@ TODO <dl id="reflect"><dt><a href="/pkg/reflect/">reflect</a></dt> <dd> <p><!-- CL 228902 --> - Package reflect now disallows accessing methods of all + Package <code>reflect</code> now disallows accessing methods of all non-exported fields, whereas previously it allowed accessing those of non-exported, embedded fields. Code that relies on the previous behavior should be updated to instead access the @@ -580,26 +608,6 @@ TODO <dl id="pkg-runtime"><dt><a href="/pkg/runtime/">runtime</a></dt> <dd> - <p><!-- CL 221779 --> - If <code>panic</code> is invoked with a value whose type is derived from any - of: <code>bool</code>, <code>complex64</code>, <code>complex128</code>, <code>float32</code>, <code>float64</code>, - <code>int</code>, <code>int8</code>, <code>int16</code>, <code>int32</code>, <code>int64</code>, <code>string</code>, - <code>uint</code>, <code>uint8</code>, <code>uint16</code>, <code>uint32</code>, <code>uint64</code>, <code>uintptr</code>, - then the value will be printed, instead of just its address. - Previously, this was only true for values of exactly these types. - </p> - - <p><!-- CL --> - On a Unix system, if the <code>kill</code> command - or <code>kill</code> system call is used to send - a <code>SIGSEGV</code>, <code>SIGBUS</code>, - or <code>SIGFPE</code> signal to a Go program, and if the signal - is not being handled via - <a href="/pkg/os/signal/#Notify"><code>os/signal.Notify</code></a>, - the Go program will now reliably crash with a stack trace. - In earlier releases the behavior was unpredictable. - </p> - <p><!-- CL 216557 --> Several functions, including <a href="/pkg/runtime/#ReadMemStats"><code>ReadMemStats</code></a> @@ -607,16 +615,6 @@ TODO <a href="/pkg/runtime/#GoroutineProfile"><code>GoroutineProfile</code></a>, no longer block if a garbage collection is in progress. </p> - - <p><!-- CL 216401 --> - Converting small integer values into an interface value no - longer causes allocation. - </p> - - <p><!-- CL 216818 --> - Non-blocking receives on closed channels now perform as well as - non-blocking receives on open channels. - </p> </dd> </dl> |