qbit/go
1
0
Fork 0
mirror of https://github.com/golang/go synced 2024-11-25 00:07:56 -07:00
Code Releases Activity

doc/go1: add more info about hash and net changes, delete reference to html

Browse Source 
R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/5570060
This commit is contained in:
Rob Pike 2012-01-24 16:36:40 -08:00
parent e7d513eab0
commit 03ea8b1c81
2 changed files with 56 additions and 22 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
doc/go1.html
View File

@ -948,18 +948,20 @@ a new method, <code>BlockSize</code>. This new method is used primarily in the
cryptographic libraries. cryptographic libraries.
</p> </p>
<p>
The <code>Sum</code> method of the
<a href="/pkg/hash/#Hash"><code>hash.Hash</code></a> interface now takes a
<code>[]byte</code> argument, to which the hash value will be appended.
The previous behavior can be recreated by adding a <code>nil</code> argument to the call.
</p>
<p> <p>
<em>Updating</em>: <em>Updating</em>:
Existing implementations of <code>hash.Hash</code> will need to add a Existing implementations of <code>hash.Hash</code> will need to add a
<code>BlockSize</code> method. Hashes that process the input one byte at <code>BlockSize</code> method. Hashes that process the input one byte at
a time can implement <code>BlockSize</code> to return 1. a time can implement <code>BlockSize</code> to return 1.
</p> Gofix will update calls to the <code>Sum</code> methods of the various
implementations of <code>hash.Hash</code>.
<h3 id="html">The html package</h3>
<p>
The <a href="/pkg/html/"><code>html</code></a> package in Go 1 provides
a full parser for HTML5.
</p> </p>
<p> <p>
@ -1124,14 +1126,29 @@ Gofix will update almost all code affected by the change.
<h3 id="net">The net package</h3> <h3 id="net">The net package</h3>
<p>In Go 1, the various <code>SetTimeout</code>, <p>
In Go 1, the various <code>SetTimeout</code>,
<code>SetReadTimeout</code>, and <code>SetWriteTimeout</code> methods <code>SetReadTimeout</code>, and <code>SetWriteTimeout</code> methods
have been replaced with <code>SetDeadline</code>, have been replaced with
<code>SetReadDeadline</code>, and <code>SetWriteDeadline</code>, <a href="/pkg/net/#IPConn.SetDeadline"><code>SetDeadline</code></a>,
<a href="/pkg/net/#IPConn.SetReadDeadline"><code>SetReadDeadline</code></a>, and
<a href="/pkg/net/#IPConn.SetWriteDeadline"><code>SetWriteDeadline</code></a>,
respectively. Rather than taking a timeout value in nanoseconds that respectively. Rather than taking a timeout value in nanoseconds that
apply to any activity on the connection, the new methods set an apply to any activity on the connection, the new methods set an
absolute deadline (as a <code>time.Time</code> value) after which absolute deadline (as a <code>time.Time</code> value) after which
reads and writes will time out and no longer block.</p> reads and writes will time out and no longer block.
</p>
<p>
There is also a new <a href="/pkg/net/#DialTimeout">net.DialTimeout</code></a> method to simplify
timing out dialing a network address.
</p>
<p>
<em>Updating</em>:
Code that uses the old methods will fail to compile and must be updated by hand.
The semantic change makes it difficult for gofix to update automatically.
</p>
<h3 id="os_fileinfo">The os.FileInfo type</h3> <h3 id="os_fileinfo">The os.FileInfo type</h3>

39
doc/go1.tmpl
View File

@ -851,18 +851,20 @@ a new method, <code>BlockSize</code>. This new method is used primarily in the
cryptographic libraries. cryptographic libraries.
</p> </p>
<p>
The <code>Sum</code> method of the
<a href="/pkg/hash/#Hash"><code>hash.Hash</code></a> interface now takes a
<code>[]byte</code> argument, to which the hash value will be appended.
The previous behavior can be recreated by adding a <code>nil</code> argument to the call.
</p>
<p> <p>
<em>Updating</em>: <em>Updating</em>:
Existing implementations of <code>hash.Hash</code> will need to add a Existing implementations of <code>hash.Hash</code> will need to add a
<code>BlockSize</code> method. Hashes that process the input one byte at <code>BlockSize</code> method. Hashes that process the input one byte at
a time can implement <code>BlockSize</code> to return 1. a time can implement <code>BlockSize</code> to return 1.
</p> Gofix will update calls to the <code>Sum</code> methods of the various
implementations of <code>hash.Hash</code>.
<h3 id="html">The html package</h3>
<p>
The <a href="/pkg/html/"><code>html</code></a> package in Go 1 provides
a full parser for HTML5.
</p> </p>
<p> <p>
@ -1027,14 +1029,29 @@ Gofix will update almost all code affected by the change.
<h3 id="net">The net package</h3> <h3 id="net">The net package</h3>
<p>In Go 1, the various <code>SetTimeout</code>, <p>
In Go 1, the various <code>SetTimeout</code>,
<code>SetReadTimeout</code>, and <code>SetWriteTimeout</code> methods <code>SetReadTimeout</code>, and <code>SetWriteTimeout</code> methods
have been replaced with <code>SetDeadline</code>, have been replaced with
<code>SetReadDeadline</code>, and <code>SetWriteDeadline</code>, <a href="/pkg/net/#IPConn.SetDeadline"><code>SetDeadline</code></a>,
<a href="/pkg/net/#IPConn.SetReadDeadline"><code>SetReadDeadline</code></a>, and
<a href="/pkg/net/#IPConn.SetWriteDeadline"><code>SetWriteDeadline</code></a>,
respectively. Rather than taking a timeout value in nanoseconds that respectively. Rather than taking a timeout value in nanoseconds that
apply to any activity on the connection, the new methods set an apply to any activity on the connection, the new methods set an
absolute deadline (as a <code>time.Time</code> value) after which absolute deadline (as a <code>time.Time</code> value) after which
reads and writes will time out and no longer block.</p> reads and writes will time out and no longer block.
</p>
<p>
There is also a new <a href="/pkg/net/#DialTimeout">net.DialTimeout</code></a> method to simplify
timing out dialing a network address.
</p>
<p>
<em>Updating</em>:
Code that uses the old methods will fail to compile and must be updated by hand.
The semantic change makes it difficult for gofix to update automatically.
</p>
<h3 id="os_fileinfo">The os.FileInfo type</h3> <h3 id="os_fileinfo">The os.FileInfo type</h3>