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>
This commit is contained in:
parent
acdd111e32
commit
666448abeb
@ -218,10 +218,24 @@ Do not send CLs removing the interior tags from such phrases.
|
|||||||
|
|
||||||
<h2 id="runtime">Runtime</h2>
|
<h2 id="runtime">Runtime</h2>
|
||||||
|
|
||||||
<p><!-- CL 232862 -->
|
<p><!-- CL 221779 -->
|
||||||
Go now retries system calls that return <code>EINTR</code>. This
|
If <code>panic</code> is invoked with a value whose type is derived from any
|
||||||
became more common in Go 1.14 with the addition of asynchronous
|
of: <code>bool</code>, <code>complex64</code>, <code>complex128</code>, <code>float32</code>, <code>float64</code>,
|
||||||
preemption, but is now handled transparently.
|
<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>
|
||||||
|
|
||||||
<p><!-- CL 221182, CL 229998 -->
|
<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.
|
counts, and has lower worst-case latency.
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<p>
|
<p><!-- CL 216401 -->
|
||||||
TODO
|
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>
|
</p>
|
||||||
|
|
||||||
<h2 id="compiler">Compiler</h2>
|
<h2 id="compiler">Compiler</h2>
|
||||||
@ -540,6 +560,14 @@ TODO
|
|||||||
which <code>Timeout</code> returns <code>true</code> although a
|
which <code>Timeout</code> returns <code>true</code> although a
|
||||||
deadline has not been exceeded.
|
deadline has not been exceeded.
|
||||||
</p>
|
</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>
|
</dd>
|
||||||
</dl>
|
</dl>
|
||||||
|
|
||||||
@ -559,7 +587,7 @@ TODO
|
|||||||
<dl id="reflect"><dt><a href="/pkg/reflect/">reflect</a></dt>
|
<dl id="reflect"><dt><a href="/pkg/reflect/">reflect</a></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p><!-- CL 228902 -->
|
<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
|
non-exported fields, whereas previously it allowed accessing
|
||||||
those of non-exported, embedded fields. Code that relies on the
|
those of non-exported, embedded fields. Code that relies on the
|
||||||
previous behavior should be updated to instead access 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>
|
<dl id="pkg-runtime"><dt><a href="/pkg/runtime/">runtime</a></dt>
|
||||||
<dd>
|
<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 -->
|
<p><!-- CL 216557 -->
|
||||||
Several functions, including
|
Several functions, including
|
||||||
<a href="/pkg/runtime/#ReadMemStats"><code>ReadMemStats</code></a>
|
<a href="/pkg/runtime/#ReadMemStats"><code>ReadMemStats</code></a>
|
||||||
@ -607,16 +615,6 @@ TODO
|
|||||||
<a href="/pkg/runtime/#GoroutineProfile"><code>GoroutineProfile</code></a>,
|
<a href="/pkg/runtime/#GoroutineProfile"><code>GoroutineProfile</code></a>,
|
||||||
no longer block if a garbage collection is in progress.
|
no longer block if a garbage collection is in progress.
|
||||||
</p>
|
</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>
|
</dd>
|
||||||
</dl>
|
</dl>
|
||||||
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user