Skip to content

Commit

Permalink
doc: describe tracing, mention go fix
Browse files Browse the repository at this point in the history
Also add a link to a couple of the talks from GopherCon 2015.

Change-Id: I11e1c550e999553163d3fb5e900f167c849ce33f
Reviewed-on: https://go-review.googlesource.com/12287
Reviewed-by: Andrew Gerrand <[email protected]>
  • Loading branch information
robpike committed Jul 16, 2015
1 parent b0834b5 commit 6163cf8
Showing 1 changed file with 21 additions and 4 deletions.
25 changes: 21 additions & 4 deletions doc/go1.5.html
Original file line number Diff line number Diff line change
Expand Up @@ -173,7 +173,8 @@ <h3 id="gc">Garbage collector</h3>
</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>

<h3 id="runtime">Runtime</h3>
Expand Down Expand Up @@ -531,11 +532,26 @@ <h3 id="vet_command">Go vet 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>
TODO
cmd/trace: new command to view traces (https://golang.org/cl/3601)
$ go test -trace=trace.out path/to/package
$ go tool trace [flags] pkg.test trace.out
</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>

<p>
Expand Down Expand Up @@ -928,7 +944,8 @@ <h3 id="minor_library_changes">Minor changes to the library</h3>
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
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>
Expand Down

0 comments on commit 6163cf8

Please sign in to comment.