From: bep <bjorn.erik.pedersen@gmail.com>
Date: Fri, 3 Apr 2015 20:29:57 +0000 (+0200)
Subject: helpers: add some missing documentation
X-Git-Tag: v0.14~141
X-Git-Url: http://git.maquefel.me/?a=commitdiff_plain;h=beb66c19a46189c729807d0b95186996588f40fc;p=brevno-suite%2Fhugo

helpers: add some missing documentation
---

diff --git a/helpers/general.go b/helpers/general.go
index 48e7dbd0..f6e0cbc4 100644
--- a/helpers/general.go
+++ b/helpers/general.go
@@ -159,6 +159,8 @@ type DistinctErrorLogger struct {
 	m map[string]bool
 }
 
+// Printf will ERROR log the string returned from fmt.Sprintf given the arguments,
+// but not if it has been logged before.
 func (l *DistinctErrorLogger) Printf(format string, v ...interface{}) {
 	logStatement := fmt.Sprintf(format, v...)
 	l.RLock()
@@ -176,6 +178,7 @@ func (l *DistinctErrorLogger) Printf(format string, v ...interface{}) {
 	l.Unlock()
 }
 
+// NewDistinctErrorLogger creates a new DistinctErrorLogger
 func NewDistinctErrorLogger() *DistinctErrorLogger {
 	return &DistinctErrorLogger{m: make(map[string]bool)}
 }
@@ -183,6 +186,7 @@ func NewDistinctErrorLogger() *DistinctErrorLogger {
 // Avoid spamming the logs with errors
 var deprecatedLogger = NewDistinctErrorLogger()
 
+// Deprecated logs ERROR logs about a deprecation, but only once for a given set of arguments' values.
 func Deprecated(object, item, alternative string) {
 	deprecatedLogger.Printf("%s's %s is deprecated and will be removed in Hugo %s. Use %s instead.", object, item, NextHugoReleaseVersion(), alternative)
 }
@@ -227,7 +231,7 @@ func Seq(args ...interface{}) ([]int, error) {
 		return nil, errors.New("Invalid argument(s) to Seq")
 	}
 
-	var inc int = 1
+	var inc = 1
 	var last int
 	var first = intArgs[0]