Documentation fixes.

hash.go

@@ -0,0 +1,8 @@
+package kyber
+
+import "hash"
+
+// A HashFactory is an interface that can be mixed in to local suite definitions.
+type HashFactory interface {
+	Hash() hash.Hash
+}

xof.go

@@ -2,7 +2,6 @@ package kyber
 
 import (
 	"crypto/cipher"
-	"hash"
 	"io"
 )
 
@@ -12,7 +11,8 @@ import (
 // state of the XOF.
 type XOF interface {
 	// Write absorbs more data into the hash's state. It panics if called
-	// after Read. Use Reseed() to
+	// after Read. Use Reseed() return an XOF into a state where more data
+	// can be absorbed via Write.
 	io.Writer
 
 	// Read reads more output from the hash. It returns io.EOF if the limit
@@ -42,8 +42,3 @@ type XOFFactory interface {
 	// bytes from Read.
 	XOF(seed []byte) XOF
 }
-
-// A HashFactory factors hashes. (Tempory comment to make travis happy. Hash is disappearing soon.)
-type HashFactory interface {
-	Hash() hash.Hash
-}

xof/blake/blake.go

@@ -1,3 +1,5 @@
+// Package blake provides an implementation of kyber.XOF based on the
+// Blake2bx construction.
 package blake
 
 import (

xof/keccak/keccak.go

@@ -1,3 +1,5 @@
+// Package keccak provides an implementation of kyber.XOF based on the
+// Shake256 hash.
 package keccak
 
 import (

xof/xof.go

@@ -1 +1,3 @@
+// Package XOF holds implementations and testing code for the various
+// extendable output functions.
 package xof