From: Andrew Gerrand <adg@golang.org>
Date: Tue, 17 Jun 2014 22:46:31 +0000 (+1000)
Subject: [release-branch.go1.3] doc: add release note for 'godoc -analysis'
X-Git-Tag: go1.3~5
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=2ae4c996a1015326598267948e0fc5d40f2d8cac;p=gostls13.git

[release-branch.go1.3] doc: add release note for 'godoc -analysis'

««« CL 88560044 / d011c0dcae9c
doc: add release note for 'godoc -analysis'

Contains a link to /lib/godoc/analysis/help.html
which is not yet live.

LGTM=r
R=r, adg
CC=golang-codereviews
https://golang.org/cl/88560044
»»»

TBR=rsc
R=golang-codereviews
CC=golang-codereviews
https://golang.org/cl/104150043
---

diff --git a/doc/go1.3.html b/doc/go1.3.html
index 685d233105..ae5c025985 100644
--- a/doc/go1.3.html
+++ b/doc/go1.3.html
@@ -295,6 +295,23 @@ For example,
 (The same change was made to the compilers and linkers in <a href="/doc/go1.1#gc_flag">Go 1.1</a>.)
 </p>
 
+<h3 id="godoc">Changes to godoc</h3>
+<p>
+When invoked with the <code>-analysis</code> flag, 
+<a href="http://godoc.org/code.google.com/p/go.tools/cmd/godoc">godoc</a>
+now performs sophisticated <a href="/lib/godoc/analysis/help.html">static
+analysis</a> of the code it indexes.  
+The results of analysis are presented in both the source view and the
+package documentation view, and include the call graph of each package
+and the relationships between 
+definitions and references,
+types and their methods,
+interfaces and their implementations,
+send and receive operations on channels,
+functions and their callers, and
+call sites and their callees.
+</p>
+
 <h3 id="misc">Miscellany</h3>
 
 <p>
@@ -309,7 +326,6 @@ For the few of us that build Go distributions, the tool <code>misc/dist</code> h
 moved and renamed; it now lives in <code>misc/makerelease</code>, still in the main repository.
 </p>
 
-
 <h2 id="performance">Performance</h2>
 
 <p>