golint changes.

This is mostly commentary adjustments via
https://travis-ci.org/cloudflare/cfssl/jobs/87769654.

transport/client.go

@@ -119,7 +119,9 @@ func (tr *Transport) TLSServerConfig() (*tls.Config, error) {
 	}, nil
 }
 
-// NewTransport builds a new transport from the default
+// New builds a new transport from an identity and a before time. The
+// before time tells the transport how long before the certificate
+// expires to start attempting to update when auto-updating.
 func New(before time.Duration, identity *core.Identity) (*Transport, error) {
 	var tr = &Transport{
 		Before:   before,

transport/core/defs.go

@@ -44,7 +44,8 @@ type Identity struct {
 	Profiles map[string]map[string]string `json:"profiles"`
 }
 
-// A sensible default is to regenerate certificates the day before they expire.
+// DefaultBefore is a sensible default; attempt to regenerate certificates the
+// day before they expire.
 var DefaultBefore = 24 * time.Hour
 
 // CipherSuites are the TLS cipher suites that should be used by CloudFlare programs.

transport/example/exlib/exlib.go

@@ -12,6 +12,9 @@ import (
 )
 
 var progname = filepath.Base(os.Args[0])
+
+// Before set to 5 minutes; certificates will attempt to auto-update 5
+// minutes before they expire.
 var Before = 5 * time.Minute
 
 // Err displays a formatting error message to standard error,

transport/roots/provider.go

@@ -11,6 +11,8 @@ import (
 	"github.com/cloudflare/cfssl/transport/roots/system"
 )
 
+// Providers is a mapping of supported providers and the functions
+// that can build them.
 var Providers = map[string]func(map[string]string) ([]*x509.Certificate, error){
 	"system": system.New,
 	"cfssl":  NewCFSSL,
@@ -52,6 +54,7 @@ func (ts *TrustStore) addCerts(certs []*x509.Certificate) {
 	}
 }
 
+// Trusted contains a store of trusted certificates.
 type Trusted interface {
 	// Certificates returns a slice containing the certificates
 	// that are loaded into the provider.

transport/transport_test.go

@@ -127,7 +127,7 @@ func TestTransportSetup(t *testing.T) {
 	var before = 55 * time.Second
 	var err error
 
-	tr, err = NewTransport(before, testIdentity)
+	tr, err = New(before, testIdentity)
 	if err != nil {
 		t.Fatalf("failed to set up transport: %v", err)
 	}
@@ -225,7 +225,7 @@ func testListen(t *testing.T) {
 func TestListener(t *testing.T) {
 	var before = 55 * time.Second
 
-	trl, err := NewTransport(before, testLIdentity)
+	trl, err := New(before, testLIdentity)
 	if err != nil {
 		t.Fatalf("failed to set up transport: %v", err)
 	}