From cfc9f10a6eb32b59fccdf14598f85297172a06a8 Mon Sep 17 00:00:00 2001
From: Matthias Kadenbach <matthias.kadenbach@gmail.com>
Date: Thu, 9 Feb 2017 18:23:08 -0800
Subject: [PATCH] add some more comments

---
 log.go          | 6 ++++++
 migrate_test.go | 2 +-
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/log.go b/log.go
index 9810b6b61..cb00b7798 100644
--- a/log.go
+++ b/log.go
@@ -1,6 +1,12 @@
 package migrate
 
+// Logger is an interface so you can pass in your own
+// logging implementation.
 type Logger interface {
+
+	// Printf is like fmt.Printf
 	Printf(format string, v ...interface{})
+
+	// Verbose should return true when verbose logging output is wanted
 	Verbose() bool
 }
diff --git a/migrate_test.go b/migrate_test.go
index 1b5356895..8dcfda002 100644
--- a/migrate_test.go
+++ b/migrate_test.go
@@ -14,10 +14,10 @@ import (
 	sStub "github.com/mattes/migrate/source/stub"
 )
 
+// sourceStubMigrations hold the following migrations:
 // u = up migration, d = down migration, n = version
 //  |  1  |  -  |  3  |  4  |  5  |  -  |  7  |
 //  | u d |  -  | u   | u d |   d |  -  | u d |
-
 var sourceStubMigrations *source.Migrations
 
 func init() {