From 12566a60d789077bcaeb699879695060cae6f8c4 Mon Sep 17 00:00:00 2001 From: Brad Fitzpatrick Date: Thu, 18 Apr 2013 12:43:23 -0700 Subject: [PATCH] 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://golang.org/cl/8729050 --- doc/go1.1.html | 21 +++++++++++++-------- doc/go1.html | 10 +++++----- doc/reference.html | 2 +- 3 files changed, 19 insertions(+), 14 deletions(-) diff --git a/doc/go1.1.html b/doc/go1.1.html index 03a457dc586..71517fc2d81 100644 --- a/doc/go1.1.html +++ b/doc/go1.1.html @@ -215,7 +215,7 @@ i := int(int32(x))

Heap size on 64-bit architectures

-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.)

@@ -288,8 +288,9 @@ The byte-order-mark change is strictly backward-compatible.

Race detector

-A major addition to the tools is a race detector, 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 race detector, 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 go 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

The gc assemblers

-Due to the change of the int to 64 bits and some other changes, +Due to the change of the int to 64 bits and +a new internal representation of functions, 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 go get command no longer allows $GOROOT as the default destination when downloading package source. To use the go get -command, a valid $GOPATH is now required. +command, a valid $GOPATH is now required. 

@@ -358,7 +360,8 @@ package code.google.com/p/foo/quxx: cannot download, $GOPATH must not be set to
 
Changes to the go test command

 
 

-The go test command no longer deletes the binary when run with profiling enabled,
+The go test
+command no longer deletes the binary when run with profiling enabled,
 to make it easier to analyze the profile.
 The implementation sets the -c flag automatically, so after running,
 

@@ -372,7 +375,8 @@ the file mypackage.test will be left in the directory where g
 

 
 

-The go test command can now generate profiling information
+The go test
+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.
 
Changes to the go run command

 
 

-The go run command now runs all files in the current working
+The go run
+command now runs all files in the current working
 directory if no file arguments are listed. Also, the go run
 command now returns an error if test files are provided on the command line. In
 this sense, "go run" replaces "go run *.go".
diff --git a/doc/go1.html b/doc/go1.html
index 491fd7bf737..2687827c0e3 100644
--- a/doc/go1.html
+++ b/doc/go1.html
@@ -998,9 +998,9 @@ Running go fix will perform the needed changes.
 

 In Go 1, the
 CreateCertificate
-and
-CreateCRL
-functions in crypto/x509 have been altered to take an
+function and
+CreateCRL
+method in crypto/x509 have been altered to take an
 interface{} where they previously took a *rsa.PublicKey
 or *rsa.PrivateKey. This will allow other public key algorithms
 to be implemented in the future.
@@ -1183,7 +1183,7 @@ if set to AllDecls, all declara
 (not just exported ones) are considered.
 The function NewFileDoc was removed, and the function
 CommentText has become the method
-Text of
+Text of
 ast.CommentGroup.
 

 
@@ -1497,7 +1497,7 @@ to test common error properties, plus a few new error values
 with more Go-like names, such as
 ErrPermission
 and
-ErrNoEnv.
+ErrNotExist.
 

 
 

diff --git a/doc/reference.html b/doc/reference.html
index 88957bc67b6..241d75a4396 100644
--- a/doc/reference.html
+++ b/doc/reference.html
@@ -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 compatibility
 requirements than the Go core.
-Install them with "go get".
+Install them with "go get".