hash: tweak the package docs

No semantic change.
I found the wording distracting in a couple of instances and was moved to improve it.

R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/10478048

diff --git a/src/pkg/hash/hash.go b/src/pkg/hash/hash.go
index aa895cf98470ce10939a84b6ae95b530c03143a8..8d138d07f93516afa84a64c6e15fc379454a6580 100644 (file)
--- a/src/pkg/hash/hash.go
+++ b/src/pkg/hash/hash.go
@@ -9,7 +9,7 @@ import "io"
 
 // Hash is the common interface implemented by all hash functions.
 type Hash interface {
-       // Write adds more data to the running hash.
+       // Write (via the embedded io.Writer interface) adds more data to the running hash.
        // It never returns an error.
        io.Writer
 
@@ -17,7 +17,7 @@ type Hash interface {
        // It does not change the underlying hash state.
        Sum(b []byte) []byte
 
-       // Reset resets the hash to one with zero bytes written.
+       // Reset resets the Hash to its initial state.
        Reset()
 
        // Size returns the number of bytes Sum will return.