*: fix all comment-related golint warnings

Some of this code is going to be moved to SDK library, so it's important.

Signed-off-by: Roman Khimov <roman@nspcc.ru>

logger/grpc.go

@@ -12,12 +12,15 @@ type (
 		log *zap.SugaredLogger
 	}
 
+	// Logger includes grpclog.LoggerV2 interface with an additional
+	// Println method.
 	Logger interface {
 		grpclog.LoggerV2
 		Println(v ...interface{})
 	}
 )
 
+// GRPC wraps given zap.Logger into grpclog.LoggerV2+ interface.
 func GRPC(l *zap.Logger) Logger {
 	log := l.WithOptions(
 		// skip gRPCLog + zapLogger in caller
@@ -29,32 +32,47 @@ func GRPC(l *zap.Logger) Logger {
 	}
 }
 
+// Info implements grpclog.LoggerV2.
 func (z *zapLogger) Info(args ...interface{}) { z.log.Info(args...) }
 
+// Infoln implements grpclog.LoggerV2.
 func (z *zapLogger) Infoln(args ...interface{}) { z.log.Info(args...) }
 
+// Infof implements grpclog.LoggerV2.
 func (z *zapLogger) Infof(format string, args ...interface{}) { z.log.Infof(format, args...) }
 
+// Println allows to print a line with info severity.
 func (z *zapLogger) Println(args ...interface{}) { z.log.Info(args...) }
 
+// Printf implements grpclog.LoggerV2.
 func (z *zapLogger) Printf(format string, args ...interface{}) { z.log.Infof(format, args...) }
 
+// Warning implements grpclog.LoggerV2.
 func (z *zapLogger) Warning(args ...interface{}) { z.log.Warn(args...) }
 
+// Warningln implements grpclog.LoggerV2.
 func (z *zapLogger) Warningln(args ...interface{}) { z.log.Warn(args...) }
 
+// Warningf implements grpclog.LoggerV2.
 func (z *zapLogger) Warningf(format string, args ...interface{}) { z.log.Warnf(format, args...) }
 
+// Error implements grpclog.LoggerV2.
 func (z *zapLogger) Error(args ...interface{}) { z.log.Error(args...) }
 
+// Errorln implements grpclog.LoggerV2.
 func (z *zapLogger) Errorln(args ...interface{}) { z.log.Error(args...) }
 
+// Errorf implements grpclog.LoggerV2.
 func (z *zapLogger) Errorf(format string, args ...interface{}) { z.log.Errorf(format, args...) }
 
+// Fatal implements grpclog.LoggerV2.
 func (z *zapLogger) Fatal(args ...interface{}) { z.log.Fatal(args...) }
 
+// Fatalln implements grpclog.LoggerV2.
 func (z *zapLogger) Fatalln(args ...interface{}) { z.log.Fatal(args...) }
 
+// Fatalf implements grpclog.LoggerV2.
 func (z *zapLogger) Fatalf(format string, args ...interface{}) { z.log.Fatalf(format, args...) }
 
+// V implements grpclog.LoggerV2.
 func (z *zapLogger) V(int) bool { return z.Enabled(zapcore.DebugLevel) }

logger/option.go

@@ -2,22 +2,32 @@ package logger
 
 import "go.uber.org/zap"
 
+// WithSamplingInitial returns Option that sets sampling initial parameter.
 func WithSamplingInitial(v int) Option { return func(o *options) { o.SamplingInitial = v } }
 
+// WithSamplingThereafter returns Option that sets sampling thereafter parameter.
 func WithSamplingThereafter(v int) Option { return func(o *options) { o.SamplingThereafter = v } }
 
+// WithFormat returns Option that sets format parameter.
 func WithFormat(v string) Option { return func(o *options) { o.Format = v } }
 
+// WithLevel returns Option that sets Level parameter.
 func WithLevel(v string) Option { return func(o *options) { o.Level = v } }
 
+// WithTraceLevel returns Option that sets trace level parameter.
 func WithTraceLevel(v string) Option { return func(o *options) { o.TraceLevel = v } }
 
+// WithoutDisclaimer returns Option that disables disclaimer.
 func WithoutDisclaimer() Option { return func(o *options) { o.NoDisclaimer = true } }
 
+// WithoutCaller returns Option that disables caller printing.
 func WithoutCaller() Option { return func(o *options) { o.NoCaller = true } }
 
+// WithAppName returns Option that sets application name.
 func WithAppName(v string) Option { return func(o *options) { o.AppName = v } }
 
+// WithAppVersion returns Option that sets application version.
 func WithAppVersion(v string) Option { return func(o *options) { o.AppVersion = v } }
 
+// WithZapOptions returns Option that sets zap logger options.
 func WithZapOptions(opts ...zap.Option) Option { return func(o *options) { o.Options = opts } }

logger/zap.go

@@ -8,6 +8,7 @@ import (
 )
 
 type (
+	// Option represents logger option setter.
 	Option func(o *options)
 
 	options struct {
@@ -77,6 +78,8 @@ func defaults() *options {
 	}
 }
 
+// New returns new zap.Logger using all options specified and stdout used
+// for output.
 func New(opts ...Option) (*zap.Logger, error) {
 	o := defaults()
 	c := zap.NewProductionConfig()