qbit/go
1
0
Fork 0
mirror of https://github.com/golang/go synced 2024-11-21 15:54:43 -07:00
Code Releases Activity

doc: misc tweaks, new links, fix broken links

Browse Source 
I read docs and wrote a crawler + link checker on the plane,
which also checks for #fragments. I'll send that out later
when it's less gross.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/8729050
This commit is contained in:
Brad Fitzpatrick 2013-04-18 12:43:23 -07:00
parent de2fcae372
commit 12566a60d7
3 changed files with 19 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
doc/go1.1.html
View File

@ -215,7 +215,7 @@ i := int(int32(x))
<h3 id="heap">Heap size on 64-bit architectures</h3>
<p>
On 64-bit architectures only, the maximum heap size has been enlarged substantially,
On 64-bit architectures, the maximum heap size has been enlarged substantially,
from a few gigabytes to several tens of gigabytes.
(The exact details depend on the system and may change.)
</p>
@ -288,8 +288,9 @@ The byte-order-mark change is strictly backward-compatible.
<h3 id="race">Race detector</h3>
<p>
A major addition to the tools is a <em>race detector</em>, a way to find
bugs in programs caused by problems like concurrent changes to the same variable.
A major addition to the tools is a <em>race detector</em>, a way to
find bugs in programs caused by concurrent access of the same
variable, where at least one of the accesses is a write.
This new facility is built into the <code>go</code> tool.
For now, it is only available on Linux, Mac OS X, and Windows systems with
64-bit x86 processors.
@ -301,7 +302,8 @@ The race detector is documented in <a href="/doc/articles/race_detector.html">a
<h3 id="gc_asm">The gc assemblers</h3>
<p>
Due to the change of the <a href="#int"><code>int</code></a> to 64 bits and some other changes,
Due to the change of the <a href="#int"><code>int</code></a> to 64 bits and
a new internal <a href="http://golang.org/s/go11func">representation of functions</a>,
the arrangement of function arguments on the stack has changed in the gc tool chain.
Functions written in assembly will need to be revised at least
to adjust frame pointer offsets.
@ -336,7 +338,7 @@ can't load package: package foo/quxx: cannot find package "foo/quxx" in any of:
Second, the <code>go get</code> command no longer allows <code>$GOROOT</code>
as the default destination when downloading package source.
To use the <code>go get</code>
command, a valid <code>$GOPATH</code> is now required.
command, a <a href="/doc/code.html#GOPATH">valid <code>$GOPATH</code></a> is now required.
</p>
<pre>
@ -358,7 +360,8 @@ package code.google.com/p/foo/quxx: cannot download, $GOPATH must not be set to
<h3 id="gotest">Changes to the go test command</h3>
<p>
The <code>go test</code> command no longer deletes the binary when run with profiling enabled,
The <a href="/cmd/go/#hdr-Test_packages"><code>go test</code></a>
command no longer deletes the binary when run with profiling enabled,
to make it easier to analyze the profile.
The implementation sets the <code>-c</code> flag automatically, so after running,
</p>
@ -372,7 +375,8 @@ the file <code>mypackage.test</code> will be left in the directory where <code>g
</p>
<p>
The <code>go test</code> command can now generate profiling information
The <a href="/cmd/go/#hdr-Test_packages"><code>go test</code></a>
command can now generate profiling information
that reports where goroutines are blocked, that is,
where they tend to stall waiting for an event such as a channel communication.
The information is presented as a
@ -397,7 +401,8 @@ to convert the code to Go 1.0 first.
<h3 id="gorun">Changes to the go run command</h3>
<p>
The <code>go run</code> command now runs all files in the current working
The <a href="/cmd/go/#hdr-Compile_and_run_Go_program"><code>go run</code></a>
command now runs all files in the current working
directory if no file arguments are listed. Also, the <code>go run</code>
command now returns an error if test files are provided on the command line. In
this sense, "<code>go run</code>" replaces "<code>go run *.go</code>".

10
doc/go1.html
View File

@ -998,9 +998,9 @@ Running <code>go</code> <code>fix</code> will perform the needed changes.
<p>
In Go 1, the
<a href="/pkg/crypto/x509/#CreateCertificate"><code>CreateCertificate</code></a>
and
<a href="/pkg/crypto/x509/#CreateCRL"><code>CreateCRL</code></a>
functions in <code>crypto/x509</code> have been altered to take an
function and
<a href="/pkg/crypto/x509/#Certificate.CreateCRL"><code>CreateCRL</code></a>
method in <code>crypto/x509</code> have been altered to take an
<code>interface{}</code> where they previously took a <code>*rsa.PublicKey</code>
or <code>*rsa.PrivateKey</code>. This will allow other public key algorithms
to be implemented in the future.
@ -1183,7 +1183,7 @@ if set to <a href="/pkg/go/doc/#AllDecls"><code>AllDecls</code></a>, all declara
(not just exported ones) are considered.
The function <code>NewFileDoc</code> was removed, and the function
<code>CommentText</code> has become the method
<a href="/pkg/go/ast/#Text"><code>Text</code></a> of
<a href="/pkg/go/ast/#CommentGroup.Text"><code>Text</code></a> of
<a href="/pkg/go/ast/#CommentGroup"><code>ast.CommentGroup</code></a>.
</p>
@ -1497,7 +1497,7 @@ to test common error properties, plus a few new error values
with more Go-like names, such as
<a href="/pkg/os/#ErrPermission"><code>ErrPermission</code></a>
and
<a href="/pkg/os/#ErrNoEnv"><code>ErrNoEnv</code></a>.
<a href="/pkg/os/#ErrNotExist"><code>ErrNotExist</code></a>.
</p>
<p>

2
doc/reference.html
View File

@ -43,7 +43,7 @@ same variable in a different goroutine.
These packages are part of the Go Project but outside the main Go tree.
They are developed under looser <a href="/doc/go1compat.html">compatibility
requirements</a> than the Go core.
Install them with "<code><a href="/cmd/go/#Download_and_install_packages_and_dependencies">go get</a></code>".
Install them with "<code><a href="/cmd/go/#hdr-Download_and_install_packages_and_dependencies">go get</a></code>".
</p>
<ul>