1
0
mirror of https://github.com/golang/go synced 2024-11-21 23:24:41 -07:00

doc/go1.1.html: remove extra space; close some tags.

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/9941043
This commit is contained in:
Oling Cat 2013-06-01 10:28:04 -04:00 committed by Rob Pike
parent 7f0ee023ba
commit 5b7d422a05

View File

@ -118,7 +118,7 @@ func (w *bufio.Writer, p []byte) (n int, err error) {
<h3 id="return">Return requirements</h3> <h3 id="return">Return requirements</h3>
<p> <p>
Before Go 1.1, a function that returned a value needed an explicit "return" Before Go 1.1, a function that returned a value needed an explicit "return"
or call to <code>panic</code> at or call to <code>panic</code> at
the end of the function; this was a simple way to make the programmer the end of the function; this was a simple way to make the programmer
be explicit about the meaning of the function. But there are many cases be explicit about the meaning of the function. But there are many cases
@ -131,7 +131,7 @@ In Go 1.1, the rule about final "return" statements is more permissive.
It introduces the concept of a It introduces the concept of a
<a href="/ref/spec/#Terminating_statements"><em>terminating statement</em></a>, <a href="/ref/spec/#Terminating_statements"><em>terminating statement</em></a>,
a statement that is guaranteed to be the last one a function executes. a statement that is guaranteed to be the last one a function executes.
Examples include Examples include
"for" loops with no condition and "if-else" "for" loops with no condition and "if-else"
statements in which each half ends in a "return". statements in which each half ends in a "return".
If the final statement of a function can be shown <em>syntactically</em> to If the final statement of a function can be shown <em>syntactically</em> to
@ -172,7 +172,7 @@ from the traditional Unix flag parsing. This may affect scripts that invoke
the tool directly. the tool directly.
For example, For example,
<code>go tool 6c -Fw -Dfoo</code> must now be written <code>go tool 6c -Fw -Dfoo</code> must now be written
<code>go tool 6c -F -w -D foo</code>. <code>go tool 6c -F -w -D foo</code>.
</p> </p>
<h3 id="int">Size of int on 64-bit platforms</h3> <h3 id="int">Size of int on 64-bit platforms</h3>
@ -197,6 +197,7 @@ However, programs that contain implicit assumptions
that <code>int</code> is only 32 bits may change behavior. that <code>int</code> is only 32 bits may change behavior.
For example, this code prints a positive number on 64-bit systems and For example, this code prints a positive number on 64-bit systems and
a negative one on 32-bit systems: a negative one on 32-bit systems:
</p>
<pre> <pre>
x := ^uint32(0) // x is 0xffffffff x := ^uint32(0) // x is 0xffffffff
@ -294,7 +295,7 @@ variable, where at least one of the accesses is a write.
This new facility is built into the <code>go</code> tool. 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 For now, it is only available on Linux, Mac OS X, and Windows systems with
64-bit x86 processors. 64-bit x86 processors.
To enable it, set the <code>-race</code> flag when building or testing your program To enable it, set the <code>-race</code> flag when building or testing your program
(for instance, <code>go test -race</code>). (for instance, <code>go test -race</code>).
The race detector is documented in <a href="/doc/articles/race_detector.html">a separate article</a>. The race detector is documented in <a href="/doc/articles/race_detector.html">a separate article</a>.
</p> </p>
@ -331,7 +332,7 @@ including a list of paths searched, when a package cannot be located.
$ go build foo/quxx $ go build foo/quxx
can't load package: package foo/quxx: cannot find package "foo/quxx" in any of: can't load package: package foo/quxx: cannot find package "foo/quxx" in any of:
/home/you/go/src/pkg/foo/quxx (from $GOROOT) /home/you/go/src/pkg/foo/quxx (from $GOROOT)
/home/you/src/foo/quxx (from $GOPATH) /home/you/src/foo/quxx (from $GOPATH)
</pre> </pre>
<p> <p>
@ -343,12 +344,12 @@ command, a <a href="/doc/code.html#GOPATH">valid <code>$GOPATH</code></a> is now
<pre> <pre>
$ GOPATH= go get code.google.com/p/foo/quxx $ GOPATH= go get code.google.com/p/foo/quxx
package code.google.com/p/foo/quxx: cannot download, $GOPATH not set. For more details see: go help gopath package code.google.com/p/foo/quxx: cannot download, $GOPATH not set. For more details see: go help gopath
</pre> </pre>
<p> <p>
Finally, as a result of the previous change, the <code>go get</code> command will also fail Finally, as a result of the previous change, the <code>go get</code> command will also fail
when <code>$GOPATH</code> and <code>$GOROOT</code> are set to the same value. when <code>$GOPATH</code> and <code>$GOROOT</code> are set to the same value.
</p> </p>
<pre> <pre>
@ -427,7 +428,7 @@ To build a file only with Go 1.0.x, use the converse constraint:
<p> <p>
The Go 1.1 tool chain adds experimental support for <code>freebsd/arm</code>, The Go 1.1 tool chain adds experimental support for <code>freebsd/arm</code>,
<code>netbsd/386</code>, <code>netbsd/amd64</code>, <code>netbsd/arm</code>, <code>netbsd/386</code>, <code>netbsd/amd64</code>, <code>netbsd/arm</code>,
<code>openbsd/386</code> and <code>openbsd/amd64</code> platforms. <code>openbsd/386</code> and <code>openbsd/amd64</code> platforms.
</p> </p>
@ -546,7 +547,7 @@ The Go 1.1 implementation instead returns a
to allow reading and writing to allow reading and writing
with its with its
<a href="/pkg/net/#UnixConn.ReadFrom"><code>ReadFrom</code></a> <a href="/pkg/net/#UnixConn.ReadFrom"><code>ReadFrom</code></a>
and and
<a href="/pkg/net/#UnixConn.WriteTo"><code>WriteTo</code></a> <a href="/pkg/net/#UnixConn.WriteTo"><code>WriteTo</code></a>
methods. methods.
</p> </p>
@ -665,6 +666,7 @@ This function addresses a common source of confusion in the time API.
<em>Updating</em>: <em>Updating</em>:
Code that needs to read and write times using an external format with Code that needs to read and write times using an external format with
lower precision should be modified to use the new methods. lower precision should be modified to use the new methods.
</p>
<h3 id="exp_old">Exp and old subtrees moved to go.exp and go.text subrepositories</h3> <h3 id="exp_old">Exp and old subtrees moved to go.exp and go.text subrepositories</h3>
@ -732,7 +734,7 @@ See the relevant package documentation for more information about each change.
</p> </p>
<ul> <ul>
<li> <li>
The <a href="/pkg/bytes/"><code>bytes</code></a> package has two new functions, The <a href="/pkg/bytes/"><code>bytes</code></a> package has two new functions,
<a href="/pkg/bytes/#TrimPrefix"><code>TrimPrefix</code></a> <a href="/pkg/bytes/#TrimPrefix"><code>TrimPrefix</code></a>
and and
@ -745,7 +747,7 @@ provides some control over memory allocation inside the buffer.
Finally, the Finally, the
<a href="/pkg/bytes/#Reader"><code>Reader</code></a> type now has a <a href="/pkg/bytes/#Reader"><code>Reader</code></a> type now has a
<a href="/pkg/strings/#Reader.WriteTo"><code>WriteTo</code></a> method <a href="/pkg/strings/#Reader.WriteTo"><code>WriteTo</code></a> method
so it implements the so it implements the
<a href="/pkg/io/#WriterTo"><code>io.WriterTo</code></a> interface. <a href="/pkg/io/#WriterTo"><code>io.WriterTo</code></a> interface.
</li> </li>
@ -772,7 +774,7 @@ and a new function
<li> <li>
The <a href="/pkg/database/sql/"><code>database/sql</code></a> package The <a href="/pkg/database/sql/"><code>database/sql</code></a> package
has a new has a new
<a href="/pkg/database/sql/#DB.Ping"><code>Ping</code></a> <a href="/pkg/database/sql/#DB.Ping"><code>Ping</code></a>
method for its method for its
<a href="/pkg/database/sql/#DB"><code>DB</code></a> <a href="/pkg/database/sql/#DB"><code>DB</code></a>
@ -922,11 +924,11 @@ The <a href="/pkg/net/"><code>net</code></a> package adds
</li> </li>
<li> <li>
The <a href="/pkg/net/"><code>net</code></a> package adds protocol-specific The <a href="/pkg/net/"><code>net</code></a> package adds protocol-specific
packet reading and writing methods to packet reading and writing methods to
<a href="/pkg/net/#IPConn"><code>IPConn</code></a> <a href="/pkg/net/#IPConn"><code>IPConn</code></a>
(<a href="/pkg/net/#IPConn.ReadMsgIP"><code>ReadMsgIP</code></a> (<a href="/pkg/net/#IPConn.ReadMsgIP"><code>ReadMsgIP</code></a>
and <a href="/pkg/net/#IPConn.WriteMsgIP"><code>WriteMsgIP</code></a>) and and <a href="/pkg/net/#IPConn.WriteMsgIP"><code>WriteMsgIP</code></a>) and
<a href="/pkg/net/#UDPConn"><code>UDPConn</code></a> <a href="/pkg/net/#UDPConn"><code>UDPConn</code></a>
(<a href="/pkg/net/#UDPConn.ReadMsgUDP"><code>ReadMsgUDP</code></a> and (<a href="/pkg/net/#UDPConn.ReadMsgUDP"><code>ReadMsgUDP</code></a> and
<a href="/pkg/net/#UDPConn.WriteMsgUDP"><code>WriteMsgUDP</code></a>). <a href="/pkg/net/#UDPConn.WriteMsgUDP"><code>WriteMsgUDP</code></a>).
@ -934,15 +936,15 @@ These are specialized versions of <a href="/pkg/net/#PacketConn"><code>PacketCon
<code>ReadFrom</code> and <code>WriteTo</code> methods that provide access to out-of-band data associated <code>ReadFrom</code> and <code>WriteTo</code> methods that provide access to out-of-band data associated
with the packets. with the packets.
</li> </li>
<li> <li>
The <a href="/pkg/net/"><code>net</code></a> package adds methods to The <a href="/pkg/net/"><code>net</code></a> package adds methods to
<a href="/pkg/net/#UnixConn"><code>UnixConn</code></a> to allow closing half of the connection <a href="/pkg/net/#UnixConn"><code>UnixConn</code></a> to allow closing half of the connection
(<a href="/pkg/net/#UnixConn.CloseRead"><code>CloseRead</code></a> and (<a href="/pkg/net/#UnixConn.CloseRead"><code>CloseRead</code></a> and
<a href="/pkg/net/#UnixConn.CloseWrite"><code>CloseWrite</code></a>), <a href="/pkg/net/#UnixConn.CloseWrite"><code>CloseWrite</code></a>),
matching the existing methods of <a href="/pkg/net/#TCPConn"><code>TCPConn</code></a>. matching the existing methods of <a href="/pkg/net/#TCPConn"><code>TCPConn</code></a>.
</li> </li>
<li> <li>
The <a href="/pkg/net/http/"><code>net/http</code></a> package includes several new additions. The <a href="/pkg/net/http/"><code>net/http</code></a> package includes several new additions.
<a href="/pkg/net/http/#ParseTime"><code>ParseTime</code></a> parses a time string, trying <a href="/pkg/net/http/#ParseTime"><code>ParseTime</code></a> parses a time string, trying
@ -1020,7 +1022,7 @@ including disabling it altogether.
<li> <li>
The <a href="/pkg/sort/"><code>sort</code></a> package has a new function, The <a href="/pkg/sort/"><code>sort</code></a> package has a new function,
<a href="/pkg/sort/#Reverse"><code>Reverse</code></a>. <a href="/pkg/sort/#Reverse"><code>Reverse</code></a>.
Wrapping the argument of a call to Wrapping the argument of a call to
<a href="/pkg/sort/#Sort"><code>sort.Sort</code></a> <a href="/pkg/sort/#Sort"><code>sort.Sort</code></a>
with a call to <code>Reverse</code> causes the sort order to be reversed. with a call to <code>Reverse</code> causes the sort order to be reversed.
</li> </li>