Add in docstrings/package doc

Makefile

@@ -0,0 +1,15 @@
+all: build test check
+
+build:
+
+test:
+	go test -v ./...
+
+check-lint:
+	revive ./...
+
+check: check-lint
+
+clean:
+
+.PHONY: build check test

doc.go

@@ -18,6 +18,8 @@
 // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 // THE SOFTWARE. }}}
 
+// Package tap contains bindings to create TAP/TUN interfaces on Linux and
+// OpenBSD.
 package tap
 
 // vim: foldmethod=marker

tap.go

@@ -29,6 +29,7 @@ import (
 	"golang.org/x/sys/unix"
 )
 
+// Interface is a handle to a created TAP/TUN interface.
 type Interface struct {
 	name   [syscall.IFNAMSIZ]byte
 	fd     *os.File
@@ -37,15 +38,20 @@ type Interface struct {
 	ps     platformState
 }
 
+// Name will return the UNIX interface name for the TAP/TUN interface.
 func (i Interface) Name() string {
 	return unix.ByteSliceToString(i.name[:])
 }
 
+// Close will release all resources held by this Interface.
 func (i Interface) Close() error {
 	i.cancel()
 	return nil
 }
 
+// Options contains a number of configuration params for the creation of
+// the TAP/TUN interface. The PlatformOptions struct is OS dependent, and
+// may contain options on your OS that are not present on other OSs.
 type Options struct {
 	PlatformOptions PlatformOptions
 }