common: fixups

common/hexutil/hexutil.go

@@ -39,7 +39,7 @@ import (
 
 const uintBits = 32 << (uint64(^uint(0)) >> 63)
 
-// Variables that specify custom error messages.
+// Errors
 var (
 	ErrEmptyString   = &decError{"empty hex string"}
 	ErrSyntax        = &decError{"invalid hex string"}

common/math/big.go

@@ -22,14 +22,13 @@ import (
 	"math/big"
 )
 
-// Variables allocated a new Int set used to find complement numbers
-// and bound maximum byte lengths.
+// Various big integer limit values.
 var (
 	tt255     = BigPow(2, 255)
 	tt256     = BigPow(2, 256)
 	tt256m1   = new(big.Int).Sub(tt256, big.NewInt(1))
-	MaxBig256 = new(big.Int).Set(tt256m1)
 	tt63      = BigPow(2, 63)
+	MaxBig256 = new(big.Int).Set(tt256m1)
 	MaxBig63  = new(big.Int).Sub(tt63, big.NewInt(1))
 )
 

common/mclock/mclock.go

@@ -23,10 +23,10 @@ import (
 	"github.com/aristanetworks/goarista/monotime"
 )
 
-// AbsTime will convert an integer number of units to a Duration in hours.
-type AbsTime time.Duration // absolute monotonic time
+// AbsTime represents absolute monotonic time.
+type AbsTime time.Duration
 
-// Now returns the current time, as a Duration, in nanoseconds from a monotonic clock
+// Now returns the current absolute monotonic time.
 func Now() AbsTime {
 	return AbsTime(monotime.Now())
 }

common/types.go

@@ -29,7 +29,7 @@ import (
 	"github.com/ethereum/go-ethereum/crypto/sha3"
 )
 
-// Const expresses the required byte length for hashes and addresses.
+// Lengths of hashes and addresses in bytes.
 const (
 	HashLength    = 32
 	AddressLength = 20