Commit 6163cf87 authored by Rob Pike's avatar Rob Pike

doc: describe tracing, mention go fix

Also add a link to a couple of the talks from GopherCon 2015.

Change-Id: I11e1c550e999553163d3fb5e900f167c849ce33f
Reviewed-on: https://go-review.googlesource.com/12287Reviewed-by: default avatarAndrew Gerrand <adg@golang.org>
parent b0834b5e
...@@ -173,7 +173,8 @@ the drop in expected latency with the new collector may be important. ...@@ -173,7 +173,8 @@ the drop in expected latency with the new collector may be important.
</p> </p>
<p> <p>
Details of the new collector were presented in TODO: GopherCon talk. Details of the new collector were presented in a
<a href="https://talks.golang.org/2015/go-gc.pdf">talk</a> at GopherCon 2015.
</p> </p>
<h3 id="runtime">Runtime</h3> <h3 id="runtime">Runtime</h3>
...@@ -531,11 +532,26 @@ more thorough validation of struct tags. ...@@ -531,11 +532,26 @@ more thorough validation of struct tags.
<h3 id="trace_command">Trace command</h3> <h3 id="trace_command">Trace command</h3>
<p>
A new tool is available for dynamic execution tracing of Go programs.
The usage is analogous to how the test coverage tool works.
Generation of traces is integrated into <code>go test</code>,
and then a separate execution of the tracing tool itself analyzes the results:
</p>
<pre> <pre>
TODO $ go test -trace=trace.out path/to/package
cmd/trace: new command to view traces (https://golang.org/cl/3601) $ go tool trace [flags] pkg.test trace.out
</pre> </pre>
<p>
The flags enable the output to be displayed in a browser window.
For details, run <code>go tool trace -help</code>.
There is also a description of the tracing facility in this
<a href="https://talks.golang.org/2015/dynamic-tools.slide">talk</a>
from GopherCon 2015.
</p>
<h3 id="doc_command">Go doc command</h3> <h3 id="doc_command">Go doc command</h3>
<p> <p>
...@@ -928,7 +944,8 @@ the new <a href="/pkg/go/types/#Qualifier"><code>Qualifier</code></a> ...@@ -928,7 +944,8 @@ the new <a href="/pkg/go/types/#Qualifier"><code>Qualifier</code></a>
function type as an argument to several functions. This is an API change for function type as an argument to several functions. This is an API change for
the package, but since it is new to the core, it is not breaking the Go 1 compatibility the package, but since it is new to the core, it is not breaking the Go 1 compatibility
rules since code that uses the package must explicitly ask for it at its new location. rules since code that uses the package must explicitly ask for it at its new location.
TODO: There should be a gofix for this. To update, run
<a href="https://golang.org/cmd/go/#hdr-Run_go_tool_fix_on_packages"><code>go fix</code></a> on your package.
</li> </li>
<li> <li>
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment