FAQ
Reviewers: golang-dev1,

Message:
Hello golang-dev@googlegroups.com,

I'd like you to review this change to
https://go.googlecode.com/hg/


Description:
doc: misc tweaks, new links, fix broken links

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.

Please review this at https://codereview.appspot.com/8729050/

Affected files:
M doc/go1.1.html
M doc/go1.html
M doc/reference.html


Index: doc/go1.1.html
===================================================================
--- a/doc/go1.1.html
+++ b/doc/go1.1.html
@@ -215,7 +215,7 @@
<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 @@
<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 @@
<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 @@
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 @@
<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 @@
</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 @@
<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>".
Index: doc/go1.html
===================================================================
--- a/doc/go1.html
+++ b/doc/go1.html
@@ -998,9 +998,9 @@
<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 @@
(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 @@
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>
Index: doc/reference.html
===================================================================
--- a/doc/reference.html
+++ b/doc/reference.html
@@ -43,7 +43,7 @@
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>


--

---
You received this message because you are subscribed to the Google Groups "golang-dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email to golang-dev+unsubscribe@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.

Search Discussions

  • R at Apr 18, 2013 at 6:08 pm
    LGTM

    https://codereview.appspot.com/8729050/

    --

    ---
    You received this message because you are subscribed to the Google Groups "golang-dev" group.
    To unsubscribe from this group and stop receiving emails from it, send an email to golang-dev+unsubscribe@googlegroups.com.
    For more options, visit https://groups.google.com/groups/opt_out.
  • Bradfitz at Apr 18, 2013 at 7:43 pm
    *** Submitted as
    https://code.google.com/p/go/source/detail?r=99117c093431 ***

    doc: misc tweaks, new links, fix broken links

    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://codereview.appspot.com/8729050


    https://codereview.appspot.com/8729050/

    --

    ---
    You received this message because you are subscribed to the Google Groups "golang-dev" group.
    To unsubscribe from this group and stop receiving emails from it, send an email to golang-dev+unsubscribe@googlegroups.com.
    For more options, visit https://groups.google.com/groups/opt_out.

Related Discussions

Discussion Navigation
viewthread | post
Discussion Overview
groupgolang-dev @
categoriesgo
postedApr 18, '13 at 6:05p
activeApr 18, '13 at 7:43p
posts3
users2
websitegolang.org

2 users in discussion

Bradfitz: 2 posts R: 1 post

People

Translate

site design / logo © 2022 Grokbase